CKTIS / C#
IMemoryOwner<T> — lastništvo pomnilniškega medpomnilnika
IMemoryOwner<T> izraža odgovornost za življenjsko dobo medpomnilnika. Lastnost Memory izpostavi njegovo vsebino kot Memory<T>, podedovani Dispose pa konča uporabo vira s strani lastnika.
Različica: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaksa
public interface IMemoryOwner<T> : IDisposable
{
Memory<T> Memory { get; }
}IMemoryOwner<T> v imenskem prostoru System.Buffers predstavlja lastnika medpomnilnika z elementi tipa T. Na voljo je v .NET 10. Medpomnilnik ima lahko v danem trenutku enega lastnika, uporablja pa ga lahko več uporabnikov. Lastništvo pomeni odgovornost za življenjsko dobo vira, ne pa izključnega dostopa do njegovih podatkov.
Lastnost IMemoryOwner<T>.Memory je tipa Memory<T> in ima samo dostopnik get. To pa ne pomeni, da so elementi nespremenljivi: spreminjati jih je mogoče prek owner.Memory.Span. Če drugemu delu kode posredujete pogled Memory<T>, s tem sami po sebi ne prenesete lastništva in ne podaljšate življenjske dobe medpomnilnika.
Vmesnik podeduje IDisposable.Dispose. Dispose() pokličite šele, ko končajo vsi uporabniki, vključno z asinhronimi operacijami; nato medpomnilnika ali shranjenih pogledov ne uporabljajte več. Implementacija lahko na primer pomnilnik vrne v zbirko. Po prenosu lastništva prejšnji lastnik medpomnilnika ne bi smel več uporabljati ali sprostiti; za to je odgovoren novi lastnik.
Primer uporablja MemoryPool<int>.Shared.Rent(3), ki zagotovi vsaj tri elemente, ne nujno natanko tri. Slice(0, 3) izbere uporabljeni del, koda pa zapiše vsak element, ki ga prebere. Blok using pokliče Dispose() tudi ob izjemi. Pričakovani izpis je 60.
Primeri
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]);
}
}
}Rezultat
60
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.