CKTIS / C#
System.IDisposable: własność zasobów i deterministyczne zwalnianie
`System.IDisposable` to kontrakt synchronicznego zwalniania zasobów. Użyj `using`, aby wyznaczyć moment zwolnienia, i określ, kto jest za nie odpowiedzialny.
Wersja: C# 12 and .NET 8; later runtimes may add compatible features
Składnia
// 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 to interfejs .NET z jedną metodą void Dispose(), bez parametrów i bez wartości zwracanej. Może ona zwolnić zasób niezarządzany, wywołać Dispose() na posiadanym obiekcie albo oddać zarządzaną tablicę do puli. Nie zwalnia pamięci samego obiektu ani nie zastępuje mechanizmu odśmiecania pamięci (GC).
Instrukcja using (...) { ... } wywołuje Dispose() przy opuszczaniu bloku; deklaracja using var resource = ...; robi to przy opuszczaniu zakresu, w którym zadeklarowano zmienną. Po pomyślnym pozyskaniu zasobu kompilator zapewnia wywołanie Dispose() za pomocą try/finally, również przy return lub wyjątku w bloku. W pokazanym przypadku, gdy zmienna ma typ System.IDisposable, wywołanie jest pomijane tylko wtedy, gdy referencja ma wartość null. using nie przechwytuje wyjątków. Do zwalniania asynchronicznego użyj await using z System.IAsyncDisposable.
Za zwolnienie odpowiada właściciel, nie kod, który tylko pożycza zasób. W przykładzie IBufferLease dziedziczy po IDisposable, a ResourceScope sam implementuje IDisposable, przejmuje odpowiedzialność za dzierżawę i przekazuje jej wywołanie Dispose(). BufferLease oddaje tablicę dokładnie raz do tej samej puli i odrzuca późniejszy dostęp, zgłaszając ObjectDisposedException. Kolejne wywołania Dispose() nic nie robią (idempotencja); nie oznacza to bezpieczeństwa wątkowego.
Rent(1) gwarantuje co najmniej jeden element, ale nie gwarantuje wyzerowania tablicy. Zapisz wartość przed odczytem i po zwrocie tablicy nie korzystaj z żadnej zachowanej referencji do niej. clearArray: true powoduje wyczyszczenie tablicy, jeśli pula zachowa ją do ponownego użycia; nie gwarantuje bezpiecznego usunięcia danych.
Przykłady
#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();
}
}Wynik
42 Lease disposed.
W C# 12 i .NET 8 program wypisze `42`, a potem `Lease disposed.`. Wyjście z `using` powoduje zwrot tablicy; ponowne wywołanie `scope.Dispose()` nic nie robi. Przechwycony `ObjectDisposedException` potwierdza, że dzierżawa blokuje późniejszy odczyt, a nie że pula ponownie użyła tablicy.
Powiązane lekcje
- C# · Lekcja 31 · Zaawansowany · Wersja: 3
- C# · Lekcja 32 · Zaawansowany · Wersja: 3