StringBuilder.GetChunks Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Restituisce un oggetto che può essere utilizzato per scorrere i blocchi di caratteri rappresentati in un ReadOnlyMemory<Char> creato da questa istanza di StringBuilder.
public:
System::Text::StringBuilder::ChunkEnumerator GetChunks();public System.Text.StringBuilder.ChunkEnumerator GetChunks ();member this.GetChunks : unit -> System.Text.StringBuilder.ChunkEnumeratorPublic Function GetChunks () As StringBuilder.ChunkEnumeratorRestituisce
Enumeratore per i blocchi nel ReadOnlyMemory<Char>.
Commenti
È possibile eseguire l'iterazione dei blocchi nell'intervallo di memoria con codice simile al seguente:
foreach (ReadOnlyMemory<char> chunk in sb.GetChunks())
foreach(char ch in chunk.Span)
{ /* operations on ch */ }
Lo scopo di questo metodo è estrarre in modo efficiente i dati di una costante StringBuilder. Se la StringBuilder viene modificata mentre l'enumerazione del blocco è incompleta, il risultato non è definito. StringBuilder non è inoltre thread-safe, quindi operare su di esso con thread simultanei è illegale.
I blocchi ReadOnlyMemory<T> restituiti non rimangono invariati se il StringBuilder viene modificato, quindi non memorizzarli nella cache per usarli in un secondo momento.
La creazione di un ReadOnlySpan<T> da un ReadOnlyMemory<T> (come nel metodo ReadOnlyMemory<T>.Span nell'esempio precedente) è costosa, quindi creare una variabile locale per l'intervallo se è necessario usarla in un'istruzione for annidata. Per esempio:
foreach (ReadOnlyMemory<char> chunk in sb.GetChunks())
{
var span = chunk.Span;
for(int i = 0; i < span.Length; i++)
{
/* operations on span[i] */
}
}
