CKTIS / C#
IMemoryOwner<T> — eigenaarschap van een geheugenbuffer
IMemoryOwner<T> drukt de verantwoordelijkheid voor de levensduur van een buffer uit. De eigenschap Memory stelt de inhoud beschikbaar als Memory<T>; de overgeërfde Dispose beëindigt het gebruik van de resource door de eigenaar.
Versie: .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> in de naamruimte System.Buffers vertegenwoordigt de eigenaar van een buffer met elementen van het type T. De interface is beschikbaar in .NET 10. Een buffer heeft op elk moment één eigenaar, maar kan meerdere gebruikers hebben. Eigenaarschap betekent verantwoordelijkheid voor de levensduur van de resource, niet exclusieve toegang tot de gegevens.
De eigenschap IMemoryOwner<T>.Memory heeft het type Memory<T> en alleen een get-accessor. Dat maakt de elementen echter niet onveranderlijk: ze kunnen via owner.Memory.Span worden gewijzigd. Een Memory<T>-weergave aan andere code doorgeven, draagt op zichzelf het eigenaarschap niet over en verlengt de levensduur van de buffer niet.
De interface erft IDisposable.Dispose. Roep Dispose() pas aan wanneer alle gebruikers, inclusief asynchrone bewerkingen, klaar zijn; gebruik daarna de buffer en bewaarde weergaven niet meer. Een implementatie kan het geheugen bijvoorbeeld teruggeven aan een pool. Na overdracht van het eigenaarschap hoort de vorige eigenaar de buffer niet meer te gebruiken of vrij te geven; die verantwoordelijkheid ligt bij de nieuwe eigenaar.
Het voorbeeld gebruikt MemoryPool<int>.Shared.Rent(3), dat ten minste drie elementen levert, niet noodzakelijk precies drie. Slice(0, 3) selecteert het gebruikte deel, en de code schrijft elk element dat wordt gelezen. Het using-blok roept Dispose() ook aan als er een uitzondering optreedt. De verwachte uitvoer is 60.
Voorbeelden
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]);
}
}
}Resultaat
60
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.