WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C#

Ressourcen freigeben

Beim Freigeben von Ressourcen werden diese gezielt bereinigt, sobald sie nicht mehr benötigt werden. Synchrones `using` kann `IDisposable.Dispose` aufrufen oder bei einem `ref struct` eine `Dispose`-Methode, die dem Freigabemuster entspricht. Dafür muss der Typ `IDisposable` nicht implementieren. Für asynchrone Bereinigung über `IAsyncDisposable.DisposeAsync` dient `await using`. Beide Konstruktionen sorgen beim Verlassen des Gültigkeitsbereichs für die Bereinigung, auch bei einer Ausnahme. Das ist nicht dasselbe wie die Speicherfreigabe durch die Garbage Collection.

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

Syntax

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

Das Freigeben von Ressourcen (resource disposal) ist eine kontrollierte Bereinigung, etwa das Schließen einer Datei oder das Freigeben eines Handles. IDisposable.Dispose ist eine parameterlose Methode mit Rückgabetyp void, die diese Bereinigung ausführt. Die GC gibt verwalteten Speicher frei, ruft Dispose aber nicht automatisch auf. Wenn eine gewöhnliche Variable ihren Gültigkeitsbereich verlässt, wird ihre Ressource dadurch nicht freigegeben.

Eine using (...) { ... }-Anweisung gibt ihre Ressource beim Verlassen des Blocks frei. Eine using var resource = ...;-Deklaration tut dies beim Verlassen des umschließenden Gültigkeitsbereichs. Der Compiler sorgt für die Semantik von try/finally; das gilt auch für return und die Weitergabe einer Ausnahme. Mehrere Ressourcen werden in umgekehrter Deklarationsreihenfolge freigegeben; bei einem Wert null wird der Aufruf übersprungen.

Gib Ressourcen frei, deren Lebensdauer du verwaltest; gib ein Objekt nicht allein deshalb frei, weil du eine Referenz darauf erhalten hast. Verwende die Ressource nach der Freigabe nicht weiter, sofern ihre Dokumentation dies nicht ausdrücklich erlaubt. Eine Dispose-Implementierung sollte wiederholte Aufrufe tolerieren. Ein Finalizer ist ein separater Mechanismus mit nichtdeterministischem Ausführungszeitpunkt und kein Ersatz für using.

Für asynchrone Bereinigung über IAsyncDisposable.DisposeAsync verwendest du await using; gewöhnliches using wartet nicht auf eine asynchrone Bereinigung. Das Beispiel verwendet das synchrone IDisposable: DemoResource simuliert die Bereinigung lediglich mit einer Meldung. Disposed erscheint vor Caught, weil die Bereinigung beim Verlassen des try-Gültigkeitsbereichs erfolgt.

Beispiele

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

Ergebnis

Working
Disposed
Caught

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen