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.