CKTIS / C#
System.IDisposable: собственост и детерминирано освобождаване на ресурси
`System.IDisposable` определя договора за синхронно освобождаване на ресурси. С `using` определяш кога се освобождава ресурсът, а собствеността определя кой отговаря за това.
Версия: C# 12 and .NET 8; later runtimes may add compatible features
Синтаксис
// 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 е интерфейс на .NET с един метод, void Dispose(), без параметри и без върната стойност. Той може да освободи неуправляван ресурс, да извика Dispose() за обект, който притежава, или да върне управляван масив в пул. Методът не освобождава паметта на самия обект и не замества автоматичното управление на паметта (GC).
Операторът using (...) { ... } извиква Dispose() при напускане на блока, а декларацията using var resource = ...; — при напускане на обхвата, в който е записана. След успешно придобиване на ресурс, различен от null, компилаторът осигурява извикването чрез try/finally, включително при return или изключение в блока. using не прихваща изключения. За асинхронно освобождаване използвай await using със System.IAsyncDisposable.
Собственикът отговаря за освобождаването, а не кодът, който само заема ресурса. В примера IBufferLease наследява IDisposable, а ResourceScope също имплементира IDisposable, поема собствеността върху подадения му обект от тип IBufferLease и препраща извикването на Dispose() към този обект. BufferLease връща масива точно веднъж в същия пул и отказва последващ достъп с ObjectDisposedException. Повторните извиквания на Dispose() нямат ефект (идемпотентност); това не гарантира безопасност при работа с няколко нишки.
Rent(1) гарантира поне един елемент, но не и масив, запълнен с нули. Запиши стойност преди четене и след връщането на масива не използвай запазени препратки към него. clearArray: true изчиства съдържанието на масива, ако пулът го запази за повторна употреба; това не гарантира сигурно изтриване на данните.
Примери
#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();
}
}Резултат
42 Lease disposed.
При C# 12 и .NET 8 програмата извежда `42`, а след това `Lease disposed.`. При излизане от `using` масивът се връща в пула; второто извикване на `scope.Dispose()` няма ефект. Прихванатото изключение `ObjectDisposedException` показва, че обектът отказва последващо четене, а не че пулът е използвал масива повторно.
Свързани уроци
- C# · Урок 31 · Напреднало · Версия: 3
- C# · Урок 32 · Напреднало · Версия: 3