CKTIS / C#
System.IDisposable: vlasništvo i determinističko oslobađanje resursa
`System.IDisposable` definira ugovor za sinkrono oslobađanje resursa. Uz `using` određuješ kada se resurs oslobađa, a vlasništvo određuje tko je za to odgovoran.
Verzija: 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 sučelje je platforme .NET s jednom metodom, void Dispose(), bez parametara i povratne vrijednosti. Može osloboditi neupravljani resurs, pozvati Dispose() na objektu u vlasništvu implementacije ili vratiti upravljano polje u spremnik polja. Ne oslobađa memoriju samog objekta niti zamjenjuje automatsko prikupljanje otpada (GC).
Naredba using (...) { ... } poziva Dispose() pri izlasku iz bloka, a deklaracija using var resource = ...; pri izlasku iz dosega u kojem je zapisana. Nakon uspješnog pribavljanja resursa koji nije null, prevoditelj osigurava poziv pomoću try/finally, čak i pri naredbi return ili iznimci unutar bloka. using ne hvata iznimke. Za asinkrono oslobađanje upotrijebi await using uz System.IAsyncDisposable.
Za oslobađanje je odgovoran vlasnik, a ne kôd koji samo posuđuje resurs. U primjeru IBufferLease nasljeđuje IDisposable, dok ResourceScope sam implementira IDisposable, preuzima odgovornost za posudbu i prosljeđuje joj poziv Dispose(). BufferLease vraća polje točno jednom u isti spremnik i odbija kasniji pristup iznimkom ObjectDisposedException. Ponovni pozivi metode Dispose() nemaju učinka (idempotentnost); to ne jamči sigurnost pri radu s više dretvi.
Rent(1) jamči barem jedan element, ali ne i polje inicijalizirano nulama. Prije čitanja upiši vrijednost, a nakon povrata ne upotrebljavaj nijednu sačuvanu referencu na polje. clearArray: true briše sadržaj polja ako ga spremnik zadrži za ponovnu uporabu; ne jamči sigurno brisanje podataka.
Primjeri
#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.
U C# 12 i .NET 8 program ispisuje `42`, a zatim `Lease disposed.`. Pri izlasku iz `using` polje se vraća u spremnik; drugi poziv `scope.Dispose()` nema učinka. Uhvaćena iznimka `ObjectDisposedException` pokazuje da posudba odbija kasnije čitanje, a ne da je spremnik ponovno upotrijebio polje.
Povezane lekcije
- C# · Lekcija 31 · Napredno · Verzija: 3
- C# · Lekcija 32 · Napredno · Verzija: 3