Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C#

System.IDisposable: vlastníctvo a deterministické uvoľňovanie prostriedkov

`System.IDisposable` je kontrakt na synchrónne uvoľňovanie prostriedkov. Pomocou `using` určíte, kedy sa prostriedok uvoľní; vlastníctvo určuje, kto za to zodpovedá.

Verzia: C# 12 and .NET 8; later runtimes may add compatible features

Syntax

// 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 rozhranie .NET s jedinou metódou void Dispose(), ktorá nemá parametre ani návratovú hodnotu. Môže uvoľniť nespravovaný prostriedok, zavolať Dispose() na vlastnenom objekte alebo vrátiť spravované pole do fondu polí. Neuvoľňuje pamäť samotného objektu ani nenahrádza automatickú správu pamäte (GC).

Príkaz using (...) { ... } zavolá Dispose() pri opustení bloku; deklarácia using var resource = ...; pri opustení rozsahu platnosti, v ktorom bola zapísaná. Po úspešnom získaní prostriedku, ktorý nie je null, kompilátor zabezpečí volanie pomocou try/finally, aj pri return alebo výnimke v bloku. using výnimky nezachytáva. Na asynchrónne uvoľnenie použite await using s System.IAsyncDisposable.

Za uvoľnenie zodpovedá vlastník, nie kód, ktorý si prostriedok iba požičiava. V príklade IBufferLease dedí z IDisposable a ResourceScope sám implementuje IDisposable, preberá zodpovednosť za výpožičku a odovzdáva jej volanie Dispose(). BufferLease vráti pole presne raz do toho istého fondu a neskorší prístup odmietne výnimkou ObjectDisposedException. Opakované volania Dispose() nemajú účinok (idempotencia); to nezaručuje bezpečnosť pri súbehu vlákien.

Rent(1) zaručuje najmenej jeden prvok, nie však pole vyplnené nulami. Pred čítaním zapíšte hodnotu a po vrátení poľa nepoužívajte žiadnu uloženú referenciu naň. clearArray: true vynuluje pole, ak si ho fond ponechá na opätovné použitie; nezaručuje bezpečné vymazanie údajov.

Príklady

#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();
    }
}

Výsledok

42
Lease disposed.

V C# 12 a .NET 8 program vypíše `42` a potom `Lease disposed.`. Pri opustení `using` sa pole vráti do fondu; druhé volanie `scope.Dispose()` nič neurobí. Zachytená výnimka `ObjectDisposedException` ukazuje, že výpožička odmietne neskoršie čítanie, nie že fond pole opätovne použil.

Súvisiace lekcie

  • C# · Lekcia 31 · Pokročilá · Verzia: 3
  • C# · Lekcia 32 · Pokročilá · Verzia: 3

Zdroje