CKTIS / C#
IMemoryOwner<T> — proprietà di un buffer di memoria
IMemoryOwner<T> esprime la responsabilità per la durata di vita di un buffer. La proprietà Memory ne espone il contenuto come Memory<T>, mentre Dispose, ereditato, termina l’uso della risorsa da parte del proprietario.
Versione: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintassi
public interface IMemoryOwner<T> : IDisposable
{
Memory<T> Memory { get; }
}IMemoryOwner<T> nello spazio dei nomi System.Buffers rappresenta il proprietario di un buffer di elementi di tipo T. È disponibile in .NET 10. Un buffer ha un solo proprietario alla volta, anche se può avere più utilizzatori. La proprietà comporta la responsabilità per la durata di vita della risorsa, non l’accesso esclusivo ai suoi dati.
La proprietà IMemoryOwner<T>.Memory è di tipo Memory<T> e ha solo un accessor get. Questo però non rende immutabili gli elementi: possono essere modificati tramite owner.Memory.Span. Passare una vista Memory<T> ad altro codice non trasferisce di per sé la proprietà né prolunga la durata di vita del buffer.
L’interfaccia eredita IDisposable.Dispose. Chiama Dispose() solo dopo che tutti gli utilizzatori, comprese le operazioni asincrone, hanno terminato; in seguito, non usare il buffer né le viste conservate. Un’implementazione può, per esempio, restituire la memoria a un pool. Dopo aver trasferito la proprietà, il precedente proprietario non dovrebbe usare né rilasciare il buffer; questa responsabilità passa al nuovo proprietario.
L’esempio usa MemoryPool<int>.Shared.Rent(3), che fornisce almeno tre elementi, non necessariamente esattamente tre. Slice(0, 3) seleziona la parte utilizzata e il codice scrive ogni elemento che legge. Il blocco using chiama Dispose() anche se si verifica un’eccezione. L’output previsto è 60.
Esempi
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]);
}
}
}Risultato
60
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.