CKTIS / C#
System.IDisposable: eigenaarschap en deterministisch vrijgeven
`System.IDisposable` legt het contract voor synchrone vrijgave vast. Met `using` bepaal je wanneer die plaatsvindt; eigenaarschap bepaalt wie ervoor verantwoordelijk is.
Versie: C# 12 and .NET 8; later runtimes may add compatible features
Syntax
// Separate syntax fragments, not a complete program.
// .NET API excerpt for reference only; do not redeclare it in consumer code.
namespace System
{
public interface IDisposable
{
void Dispose();
}
}
// In the two alternatives below, Acquire() is a placeholder for resource acquisition.
// Statement: dispose on exit from the block.
using (System.IDisposable resource = Acquire())
{
// Use resource.
}
// Declaration (alternative): dispose on exit from the enclosing scope.
using System.IDisposable resource = Acquire();System.IDisposable is een .NET-interface met één methode: void Dispose(), zonder parameters of retourwaarde. Die kan een onbeheerde resource vrijgeven, Dispose() aanroepen op een object waarvan de implementatie eigenaar is, of een beheerde array aan een pool teruggeven. De methode geeft het geheugen van het object zelf niet vrij en vervangt de garbagecollector (GC) niet.
Het statement using (...) { ... } roept Dispose() aan bij het verlaten van het blok. De declaratie using var resource = ...; doet dat bij het verlaten van het bereik waarin de variabele is gedeclareerd. Zodra een resource die niet null is met succes is verkregen, zorgt de compiler met try/finally voor die aanroep, ook bij return of een uitzondering in het blok. using vangt geen uitzonderingen af. Gebruik voor asynchrone vrijgave await using met System.IAsyncDisposable.
De eigenaar geeft de resource vrij, niet de code die deze alleen leent. Hier erft IBufferLease van IDisposable. ResourceScope implementeert zelf IDisposable, neemt de verantwoordelijkheid voor de lease over en geeft de Dispose()-aanroep door aan de lease. BufferLease geeft de array precies één keer terug aan dezelfde pool en weigert latere toegang met ObjectDisposedException. Herhaalde aanroepen van Dispose() hebben geen effect (idempotentie); dit garandeert geen threadveiligheid.
Rent(1) garandeert minstens één element, maar niet dat de array met nullen is gevuld. Schrijf voordat je leest en gebruik geen bewaarde verwijzingen naar de array nadat je deze hebt teruggegeven. clearArray: true wist de inhoud als de pool de array bewaart voor hergebruik; dit garandeert niet dat de gegevens veilig zijn gewist.
Voorbeelden
#nullable enable
using System;
using System.Buffers;
IBufferLease lease = new BufferLease();
IDisposable scope = new ResourceScope(lease);
using (scope)
{
lease.Value = 42;
Console.WriteLine(lease.Value);
}
scope.Dispose();
try
{
_ = lease.Value;
}
catch (ObjectDisposedException)
{
Console.WriteLine("Lease disposed.");
}
interface IBufferLease : IDisposable
{
int Value { get; set; }
}
sealed class BufferLease : IBufferLease
{
private readonly ArrayPool<int> _pool = ArrayPool<int>.Shared;
private int[]? _buffer;
public BufferLease() => _buffer = _pool.Rent(1);
private int[] Buffer =>
_buffer ?? throw new ObjectDisposedException(nameof(BufferLease));
public int Value
{
get => Buffer[0];
set => Buffer[0] = value;
}
public void Dispose()
{
int[]? buffer = _buffer;
if (buffer is null)
return;
_buffer = null;
_pool.Return(buffer, clearArray: true);
}
}
sealed class ResourceScope : IDisposable
{
private IBufferLease? _lease;
public ResourceScope(IBufferLease lease) =>
_lease = lease ?? throw new ArgumentNullException(nameof(lease));
public void Dispose()
{
IBufferLease? lease = _lease;
_lease = null;
lease?.Dispose();
}
}Resultaat
42 Lease disposed.
Met C# 12 en .NET 8 toont het programma `42` en daarna `Lease disposed.`. Bij het verlaten van `using` gaat de array terug naar de pool; de tweede aanroep van `scope.Dispose()` doet niets. De afgevangen `ObjectDisposedException` laat zien dat de lease een latere leesbewerking weigert, niet dat de pool de array heeft hergebruikt.
Gerelateerde lessen
- C# · Les 31 · Gevorderd · Versie: 3
- C# · Les 32 · Gevorderd · Versie: 3