Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C#

Libertação de recursos

A libertação de recursos é uma limpeza controlada que ocorre quando um recurso deixa de ser necessário. A construção síncrona `using` pode chamar `IDisposable.Dispose` ou, num tipo `ref struct`, um método `Dispose` que siga o padrão de libertação, mesmo que o tipo não implemente `IDisposable`. Para a limpeza assíncrona através de `IAsyncDisposable.DisposeAsync`, usa `await using`. Ambas as construções asseguram a limpeza à saída do âmbito, mesmo em caso de exceção. A libertação de recursos é distinta da recuperação de memória pelo GC.

Versão: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Sintaxe

using (Resource resource = new Resource()) { /* use resource */ }
using Resource resource = new Resource();
await using AsyncResource resource = new AsyncResource();

A libertação de recursos (resource disposal) é uma limpeza controlada, como fechar um ficheiro ou libertar um identificador. IDisposable.Dispose é um método sem parâmetros que devolve void e executa esta limpeza. O GC recupera memória gerida, mas não chama automaticamente Dispose. O simples facto de uma variável normal sair do âmbito não liberta o recurso.

Uma instrução using (...) { ... } liberta o recurso ao sair do bloco. Uma declaração using var resource = ...; fá-lo ao sair do âmbito que a contém. O compilador garante a semântica try/finally; isto também abrange return e a propagação de exceções. Vários recursos são libertados pela ordem inversa à da declaração; se o valor for null, a chamada é ignorada.

Liberta os recursos cujo ciclo de vida geres; não libertes um objeto apenas por teres recebido uma referência para ele. Depois da libertação, não uses o recurso, a menos que a documentação o permita explicitamente. Uma implementação de Dispose deve tolerar chamadas repetidas. Um finalizador é um mecanismo separado, com um momento de execução não determinístico, e não um substituto de using.

Para a limpeza assíncrona através de IAsyncDisposable.DisposeAsync, usa await using; um using normal não espera pela limpeza assíncrona. O exemplo usa IDisposable síncrono: DemoResource apenas simula a limpeza com uma mensagem. Disposed surge antes de Caught porque a limpeza ocorre ao sair do âmbito try.

Exemplos

using System;

try
{
    using var resource = new DemoResource();
    Console.WriteLine("Working");
    throw new InvalidOperationException("Demo");
}
catch (InvalidOperationException)
{
    Console.WriteLine("Caught");
}

sealed class DemoResource : IDisposable
{
    private bool disposed;

    public void Dispose()
    {
        if (disposed)
            return;

        disposed = true;
        Console.WriteLine("Disposed");
    }
}

Resultado

Working
Disposed
Caught

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes