CKTIS / C#
Resources opruimen
Resources opruimen is gecontroleerd opruimwerk zodra een resource niet meer nodig is. Synchrone `using` kan `IDisposable.Dispose` aanroepen of bij een `ref struct` een `Dispose`-methode die aan het opruimpatroon voldoet, ook als het type `IDisposable` niet implementeert. Gebruik voor asynchrone opruiming via `IAsyncDisposable.DisposeAsync` de constructie `await using`. Beide constructies regelen de opruiming bij het verlaten van de scope, ook bij een uitzondering. Dit is iets anders dan geheugen terugwinnen met de GC.
Versie: .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();Resources opruimen (resource disposal) is gecontroleerd opruimwerk, zoals een bestand sluiten of een handle vrijgeven. IDisposable.Dispose is een parameterloze methode die void retourneert en deze opruiming uitvoert. De GC wint beheerd geheugen terug, maar roept Dispose niet automatisch aan. Als een gewone variabele buiten scope raakt, wordt de bijbehorende resource daardoor niet opgeruimd.
Een using (...) { ... }-instructie ruimt de resource op wanneer het blok wordt verlaten. Een using var resource = ...;-declaratie doet dit wanneer de omringende scope wordt verlaten. De compiler zorgt voor try/finally-semantiek; dit geldt ook voor return en het doorgeven van uitzonderingen. Meerdere resources worden opgeruimd in omgekeerde volgorde van declaratie; bij de waarde null wordt de aanroep overgeslagen.
Ruim resources op waarvan je de levensduur beheert; ruim een object niet op alleen omdat je er een verwijzing naar hebt gekregen. Gebruik de resource na het opruimen niet meer, tenzij de documentatie dit uitdrukkelijk toestaat. Een Dispose-implementatie hoort herhaalde aanroepen te verdragen. Een finalizer is een apart mechanisme met een niet-deterministisch uitvoeringstijdstip, geen vervanging voor using.
Gebruik voor asynchrone opruiming via IAsyncDisposable.DisposeAsync await using; gewone using wacht niet op asynchrone opruiming. Het voorbeeld gebruikt synchrone IDisposable: DemoResource simuleert de opruiming alleen met een bericht. Disposed verschijnt vóór Caught, omdat de opruiming plaatsvindt bij het verlaten van de try-scope.
Voorbeelden
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");
}
}
Resultaat
Working Disposed Caught
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.