Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C#

IMemoryOwner<T> — vlastnictví paměťového bufferu

IMemoryOwner<T> vyjadřuje odpovědnost za dobu života bufferu. Vlastnost Memory zpřístupňuje jeho obsah jako Memory<T>, zatímco zděděná metoda Dispose ukončuje používání prostředku vlastníkem.

Verze: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Syntaxe

public interface IMemoryOwner<T> : IDisposable
{
    Memory<T> Memory { get; }
}

IMemoryOwner<T> v oboru názvů System.Buffers představuje vlastníka bufferu s prvky typu T. Je dostupné v .NET 10. Buffer má v daném okamžiku jednoho vlastníka, může jej však používat více uživatelů. Vlastnictví znamená odpovědnost za dobu života prostředku, nikoli výhradní přístup k jeho datům.

Vlastnost IMemoryOwner<T>.Memory má typ Memory<T> a pouze přístupový člen get. To ale neznamená, že jsou prvky neměnné: lze je upravovat prostřednictvím owner.Memory.Span. Předání pohledu Memory<T> jinému kódu samo o sobě nepřenáší vlastnictví ani neprodlužuje dobu života bufferu.

Rozhraní dědí IDisposable.Dispose. Zavolejte Dispose() až poté, co skončí všichni uživatelé, včetně asynchronních operací; potom buffer ani uchované pohledy nepoužívejte. Implementace může například vrátit paměť do fondu. Po předání vlastnictví by původní vlastník neměl buffer používat ani uvolňovat; odpovědnost přebírá nový vlastník.

Příklad používá MemoryPool<int>.Shared.Rent(3), které poskytne alespoň tři prvky, ne nutně přesně tři. Slice(0, 3) vybere používanou část a kód zapíše každý prvek, který čte. Blok using zavolá Dispose() i v případě výjimky. Očekávaný výstup je 60.

Příklady

using System;
using System.Buffers;

internal static class Program
{
    private static void Main()
    {
        using (IMemoryOwner<int> owner = MemoryPool<int>.Shared.Rent(3))
        {
            Memory<int> memory = owner.Memory.Slice(0, 3);
            Span<int> span = memory.Span;
            span[0] = 10;
            span[1] = 20;
            span[2] = 30;

            Console.WriteLine(span[0] + span[1] + span[2]);
        }
    }
}

Výsledek

60

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje