Freigeben über


GradientStopCollection.GetEnumerator Methode

Definition

Gibt einen Enumerator zurück, der die Auflistung durchlaufen kann.

public:
 System::Windows::Media::GradientStopCollection::Enumerator GetEnumerator();
public System.Windows.Media.GradientStopCollection.Enumerator GetEnumerator ();
member this.GetEnumerator : unit -> System.Windows.Media.GradientStopCollection.Enumerator
Public Function GetEnumerator () As GradientStopCollection.Enumerator

Gibt zurück

Ein GradientStopCollection.Enumerator, der die Auflistung durchlaufen kann.

Hinweise

Enumeratoren ermöglichen nur das Lesen der Daten in der Sammlung. Enumeratoren können nicht verwendet werden, um die zugrunde liegende Auflistung zu ändern.

Zunächst wird der Enumerator vor dem ersten Element in der Auflistung positioniert. setzt den Enumerator ebenfalls auf diese Position zurück. An dieser Position löst der Aufruf Current eine Ausnahme aus. Daher müssen Sie aufrufen MoveNext , um den Enumerator auf das erste Element der Auflistung zu weiterentwickeln, bevor Sie den Wert von Currentlesen.

Current gibt solange dasselbe Objekt zurück, bis MoveNext oder Reset aufgerufen wird. MoveNext auf das nächste Element festgelegt Current .

Nachdem das Ende der Auflistung übergeben wurde, wird der Enumerator nach dem letzten Element in der Auflistung positioniert, und der Aufruf MoveNext von gibt zurück false. Wenn der letzte Aufruf von MoveNext zurückgegeben wurde false, löst der Aufruf Current eine Ausnahme aus. Um erneut auf das erste Element der Auflistung festzulegenCurrent, können Sie gefolgt von MoveNextaufrufenReset.

Ein Enumerator bleibt gültig, solange die Auflistung unverändert bleibt. Wenn Änderungen an der Auflistung vorgenommen werden, z. B. das Hinzufügen, Ändern oder Löschen von Elementen, wird der Enumerator unwiederbringlich ungültig, und der nächste Aufruf von MoveNext oder Reset löst eine aus InvalidOperationException. Wenn die Auflistung zwischen MoveNext und Currentgeändert wird, Current gibt das Element zurück, auf das sie festgelegt ist, auch wenn der Enumerator bereits ungültig ist.

Der Enumerator hat keinen exklusiven Zugriff auf die Auflistung; daher ist die Enumeration einer Auflistung systembedingt kein threadsicheres Verfahren. Selbst wenn eine Sammlung synchronisiert wird, können andere Threads die Auflistung noch ändern, was dazu führt, dass der Enumerator eine Ausnahme auslöst. Um während der Enumeration Threadsicherheit zu gewährleisten, können Sie entweder die Auflistung während der gesamten Enumeration sperren oder die Ausnahmen, die aus von anderen Threads stammenden Änderungen resultieren, abfangen.

Gilt für: