ReadOnlySpan<T>.Enumerator ReadOnlySpan<T>.Enumerator ReadOnlySpan<T>.Enumerator ReadOnlySpan<T>.Enumerator Struct

Definition

Stellt einen Enumerator für diese Elemente eines ReadOnlySpan<T>-Elements bereit.Provides an enumerator for the elements of a ReadOnlySpan<T>.

public: value class ReadOnlySpan<T>::Enumerator
public struct ReadOnlySpan<T>.Enumerator
type ReadOnlySpan<'T>.Enumerator = struct
Public Structure ReadOnlySpan(Of T).Enumerator

Typparameter

T
Vererbung
ReadOnlySpan<T>.EnumeratorReadOnlySpan<T>.EnumeratorReadOnlySpan<T>.EnumeratorReadOnlySpan<T>.Enumerator

Hinweise

Die C#- Foreach der C#-Sprache und die für jede... Nächste Konstrukt in Visual Basic Blendet die Komplexität der Enumeratoren.The C# foreach of the C# language and the For Each...Next construct in Visual Basic hides the complexity of enumerators. Anstatt ein direktes Bearbeiten des Enumerators, mit foreach oder For Each...Next wird empfohlen.Instead of directly manipulating the enumerator, using foreach or For Each...Next is recommended.

Zunächst wird der Enumerator vor das erste Element in der ReadOnlySpan<T>.Initially, the enumerator is positioned before the first element in the ReadOnlySpan<T>. An dieser Position ist Current nicht definiert.At this position, Current is undefined. Rufen Sie MoveNext auf den Enumerator auf das erste Element in der ReadOnlySpan<T> vor dem Lesen des Werts von Current.You must call MoveNext to advance the enumerator to the first item in the ReadOnlySpan<T> before reading the value of Current.

Current Gibt den gleichen Wert bis MoveNext aufgerufen wird.Current returns the same value until MoveNext is called. MoveNext Legt Current zum nächsten Element in der ReadOnlySpan<T>.MoveNext sets Current to the next item in the ReadOnlySpan<T>.

Wenn MoveNext übergibt am Ende der ReadOnlySpan<T>, MoveNext gibt false.If MoveNext passes the end of the ReadOnlySpan<T>, MoveNext returns false. Wenn der Enumerator ist auf diesem Status, schlagen nachfolgende Aufrufe MoveNext auch zurückgeben false und Current ist nicht definiert.When the enumerator is at this state, subsequent calls to MoveNext also return false and Current is undefined. Sie können nicht festgelegt werden Current auf das erste Element in der ReadOnlySpan<T> erneut; Sie müssen eine neue Enumeratorinstanz stattdessen erstellen.You cannot set Current to the first item in the ReadOnlySpan<T> again; you must create a new enumerator instance instead.

Obwohl die ReadOnlySpan<T> zugeordnet ist, auf dem Stapel, die zugrunde liegenden Daten auf dem die ReadOnlySpan<T> verweist, möglicherweise nicht.Though the ReadOnlySpan<T> is allocated on the stack, the underlying data on which the ReadOnlySpan<T> points to, may not be. Aus diesem Grund die Enumeration eine ReadOnlySpan<T> ist systemintern keine threadsichere Prozedur.Therefore, enumerating through a ReadOnlySpan<T> is intrinsically not a thread-safe procedure. Um während der Enumeration Threadsicherheit zu gewährleisten, müssen Sie eine eigene Synchronisierung implementieren.To guarantee thread safety during enumeration, you must implement your own synchronization.

Im Gegensatz zu einigen anderen Enumerator-Strukturen in .NET die ReadOnlySpan<T>.Enumerator:Unlike some other enumerator structures in .NET, the ReadOnlySpan<T>.Enumerator:

  • Implementiert nicht die IEnumerator oder IEnumerator<T> Schnittstelle.Does not implement the IEnumerator or IEnumerator<T> interface. Grund hierfür ist, ReadOnlySpan<T>.Enumerator ist eine Referenzstruktur und können nicht geschachtelt werden.This is because ReadOnlySpan<T>.Enumerator is a ref struct and cannot be boxed.

  • Enthält keine Reset -Methode, die den Enumerator auf seine anfängliche Position vor dem ersten Element in der Spanne festlegen kann.Does not include a Reset method, which can set the enumerator to its initial position before the first element in the span. (Die IEnumerator.Reset() Methode muss als Teil der Schnittstelle implementiert werden, aber die meisten Implementierungen eine Ausnahme auslösen, oder es keine Implementierung bereitstellen.)(The IEnumerator.Reset() method must be implemented as part of the interface, but most implementors either throw an exception or provide no implementation.)

Eigenschaften

Current Current Current Current

Ruft einen Verweis auf das Element an der aktuellen Position des Enumerators ab.Gets a reference to the item at the current position of the enumerator.

Methoden

MoveNext() MoveNext() MoveNext() MoveNext()

Legt den Enumerator auf das nächste Element von ReadOnlySpan<T> fest.Advances the enumerator to the next item of the ReadOnlySpan<T>.

Gilt für: