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

CKTIS / C#

IMemoryOwner<T> — vlastníctvo pamäťového bufferu

IMemoryOwner<T> vyjadruje zodpovednosť za dobu života buffera. Vlastnosť Memory sprístupňuje jeho obsah ako Memory<T>, zatiaľ čo zdedená metóda Dispose ukončuje používanie prostriedku vlastníkom.

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

Syntax

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

IMemoryOwner<T> v priestore názvov System.Buffers predstavuje vlastníka buffera s prvkami typu T. Je dostupné v .NET 10. Buffer má v danom okamihu jedného vlastníka, môže ho však používať viac používateľov. Vlastníctvo znamená zodpovednosť za dobu života prostriedku, nie výhradný prístup k jeho údajom.

Vlastnosť IMemoryOwner<T>.Memory má typ Memory<T> a iba prístupový člen get. To však neznamená, že sú prvky nemenné: možno ich upravovať prostredníctvom owner.Memory.Span. Odovzdanie pohľadu Memory<T> inému kódu samo osebe neprenáša vlastníctvo ani nepredlžuje dobu života buffera.

Rozhranie dedí IDisposable.Dispose. Zavolajte Dispose() až po skončení všetkých používateľov vrátane asynchrónnych operácií; potom buffer ani uchované pohľady nepoužívajte. Implementácia môže napríklad vrátiť pamäť do fondu. Po odovzdaní vlastníctva by pôvodný vlastník nemal buffer používať ani uvoľňovať; zodpovednosť preberá nový vlastník.

Príklad používa MemoryPool<int>.Shared.Rent(3), ktoré poskytne aspoň tri prvky, nie nevyhnutne presne tri. Slice(0, 3) vyberie používanú časť a kód zapíše každý prvok, ktorý číta. Blok using zavolá Dispose() aj v prípade výnimky. Očakávaný výstup je 60.

Prí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ýsledok

60

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje