Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C#

Uvolňování prostředků

Uvolňování prostředků je řízený úklid, který nastává, když už prostředek není potřeba. Synchronní `using` může zavolat `IDisposable.Dispose` nebo u typu `ref struct` metodu `Dispose`, která odpovídá vzoru pro uvolňování prostředků, i když typ neimplementuje `IDisposable`. K asynchronnímu úklidu pomocí `IAsyncDisposable.DisposeAsync` slouží `await using`. Obě konstrukce zajišťují úklid při opuštění rozsahu platnosti, a to i v případě výjimky. Nejde o totéž jako uvolňování paměti pomocí GC.

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

Syntaxe

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

Uvolňování prostředků (resource disposal) je řízený úklid, například zavření souboru nebo uvolnění popisovače. IDisposable.Dispose je bezparametrová metoda vracející void, která tento úklid provádí. GC uvolňuje spravovanou paměť, ale Dispose automaticky nevolá. Když běžná proměnná opustí rozsah platnosti, její prostředek se tím sám neuvolní.

Příkaz using (...) { ... } uvolní prostředek při opuštění bloku. Deklarace using var resource = ...; tak učiní při opuštění nadřazeného rozsahu platnosti. Kompilátor zajišťuje sémantiku try/finally; vztahuje se to i na return a šíření výjimky. Více prostředků se uvolňuje v opačném pořadí, než byly deklarovány; pro hodnotu null se volání vynechá.

Uvolňujte prostředky, jejichž životní cyklus spravujete; neuvolňujte objekt jen proto, že jste dostali odkaz na něj. Po uvolnění prostředek nepoužívejte, pokud to jeho dokumentace výslovně nepovoluje. Implementace Dispose by měla snášet opakovaná volání. Finalizátor je samostatný mechanismus s nedeterministickým okamžikem spuštění, nikoli náhrada za using.

Pro asynchronní úklid pomocí IAsyncDisposable.DisposeAsync použijte await using; běžné using na asynchronní úklid nečeká. Příklad používá synchronní IDisposable: DemoResource úklid pouze simuluje zprávou. Disposed se zobrazí před Caught, protože k úklidu dojde při opuštění rozsahu try.

Příklady

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");
    }
}

Výsledek

Working
Disposed
Caught

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje