Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C#

Zwalnianie zasobów

Zwalnianie zasobów to kontrolowane sprzątanie po zakończeniu korzystania z zasobu. Synchroniczne `using` może wywołać `IDisposable.Dispose` albo metodę `Dispose` zgodną ze wzorcem zwalniania w typie `ref struct`, nawet jeśli typ nie implementuje `IDisposable`. Do asynchronicznego sprzątania za pomocą `IAsyncDisposable.DisposeAsync` służy `await using`. Obie konstrukcje zapewniają sprzątanie przy opuszczaniu zakresu, także wskutek wyjątku. Nie jest to to samo co odzyskiwanie pamięci przez GC.

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

Składnia

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

Zwalnianie zasobów (resource disposal) to kontrolowane sprzątanie, na przykład zamknięcie pliku lub zwolnienie uchwytu. IDisposable.Dispose jest bezparametrową metodą zwracającą void, która realizuje takie sprzątanie. GC odzyskuje pamięć zarządzaną, ale nie wywołuje automatycznie Dispose. Samo wyjście zwykłej zmiennej poza zakres nie zwalnia zasobu.

Instrukcja using (...) { ... } zwalnia zasób przy opuszczaniu swojego bloku. Deklaracja using var resource = ...; robi to przy opuszczaniu otaczającego zakresu. Kompilator zapewnia semantykę try/finally: dotyczy to również return i propagacji wyjątku. Kilka zasobów jest zwalnianych w odwrotnej kolejności deklaracji; dla wartości null wywołanie jest pomijane.

Zwalniaj zasoby, których cyklem życia zarządzasz; nie zwalniaj obiektu tylko dlatego, że otrzymano jego referencję. Po zwolnieniu nie używaj zasobu, chyba że jego dokumentacja wyraźnie to dopuszcza. Implementacja Dispose powinna tolerować ponowne wywołania. Finalizator jest odrębnym mechanizmem o niedeterministycznym terminie wykonania, a nie zamiennikiem using.

Do asynchronicznego sprzątania przez IAsyncDisposable.DisposeAsync służy await using; zwykłe using nie oczekuje na sprzątanie asynchroniczne. Przykład używa synchronicznego IDisposable: DemoResource tylko symuluje sprzątanie komunikatem. Disposed pojawia się przed Caught, ponieważ sprzątanie następuje podczas opuszczania zakresu try.

Przykłady

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

Wynik

Working
Disposed
Caught

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła