База знанияИзпитен център
BGБългарски
Избери език13

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

Източници