CKTIS / C#
System.IDisposable: lastništvo in deterministično sproščanje virov
`System.IDisposable` je pogodba za sinhrono sproščanje virov. Z `using` določiš trenutek sprostitve, lastništvo pa določa, kdo je zanjo odgovoren.
Različica: C# 12 and .NET 8; later runtimes may add compatible features
Sintaksa
// 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 je vmesnik .NET z eno metodo, void Dispose(), ki nima parametrov in ne vrne vrednosti. Lahko sprosti neupravljani vir, pokliče Dispose() na objektu v lasti implementacije ali vrne upravljano polje v zalogo polj. Ne sprosti pomnilnika samega objekta in ne nadomesti zbiranja smeti (GC).
Stavek using (...) { ... } pokliče Dispose() ob izhodu iz bloka, deklaracija using var resource = ...; pa ob izhodu iz dosega, v katerem je zapisana. Po uspešni pridobitvi vira, ki ni null, prevajalnik zagotovi klic prek try/finally, tudi ob return ali izjemi v bloku. using ne prestreza izjem. Za asinhrono sproščanje uporabi await using z System.IAsyncDisposable.
Za sprostitev je odgovoren lastnik, ne koda, ki si vir samo izposodi. V primeru IBufferLease deduje od IDisposable, ResourceScope pa sam implementira IDisposable, prevzame odgovornost za izposojo in ji posreduje klic Dispose(). BufferLease vrne polje natanko enkrat v isto zalogo in ob poznejšem dostopu sproži ObjectDisposedException. Ponovni klici Dispose() nimajo učinka (idempotentnost); to ne zagotavlja varnega dostopa iz več niti.
Rent(1) zagotavlja najmanj en element, ne pa polja, zapolnjenega z ničlami. Pred branjem zapiši vrednost, po vrnitvi polja pa ne uporabljaj nobene shranjene reference nanj. clearArray: true počisti vsebino polja, če ga zaloga obdrži za ponovno uporabo; ne zagotavlja varnega brisanja podatkov.
Primeri
#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();
}
}Rezultat
42 Lease disposed.
V C# 12 in .NET 8 program izpiše `42` in nato `Lease disposed.`. Ob izhodu iz `using` se polje vrne v zalogo, drugi klic `scope.Dispose()` pa nima učinka. Prestrezena izjema `ObjectDisposedException` pokaže, da izposoja zavrne poznejše branje, ne pa, da je bilo polje znova uporabljeno.
Povezane lekcije
- C# · Lekcija 31 · Napredna · Različica: 3
- C# · Lekcija 32 · Napredna · Različica: 3