StringBuilder.GetChunks Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt ein Objekt zurück, das zum Durchlaufen der Blöcke von Zeichen verwendet werden kann, die in einer ReadOnlyMemory<Char> aus dieser StringBuilder Instanz erstellt wurden.
public:
System::Text::StringBuilder::ChunkEnumerator GetChunks();public System.Text.StringBuilder.ChunkEnumerator GetChunks ();member this.GetChunks : unit -> System.Text.StringBuilder.ChunkEnumeratorPublic Function GetChunks () As StringBuilder.ChunkEnumeratorGibt zurück
Ein Enumerator für die Blöcke im ReadOnlyMemory<Char>.
Hinweise
Sie können die Blöcke im Speicherbereich mit Code wie den folgenden durchlaufen:
foreach (ReadOnlyMemory<char> chunk in sb.GetChunks())
foreach(char ch in chunk.Span)
{ /* operations on ch */ }
Zweck dieser Methode ist es, die Daten einer KonstantenStringBuildereffizient zu extrahieren. Wenn das StringBuilder geändert wird, während die Blockaufzählung unvollständig ist, ist das Ergebnis nicht definiert. StringBuilder ist auch nicht threadsicher, sodass das Arbeiten mit gleichzeitigen Threads unzulässig ist.
Die zurückgegebenen ReadOnlyMemory<T> Blöcke werden nicht garantiert unverändert bleiben, wenn die StringBuilder geändert wird. Speichern Sie sie daher nicht für die spätere Verwendung zwischen.
Das Erstellen einer ReadOnlySpan<T> aus einem ReadOnlyMemory<T> (wie die ReadOnlyMemory<T>.Span-Methode im vorherigen Beispiel ausgeführt wird) ist teuer. Erstellen Sie daher eine lokale Variable für die Spanne, wenn Sie sie in einer geschachtelten for-Anweisung verwenden müssen. Zum Beispiel:
foreach (ReadOnlyMemory<char> chunk in sb.GetChunks())
{
var span = chunk.Span;
for(int i = 0; i < span.Length; i++)
{
/* operations on span[i] */
}
}
