Point3DCollection.GetEnumerator Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Zwraca moduł wyliczający, który może wykonać iterację kolekcji.
public:
System::Windows::Media::Media3D::Point3DCollection::Enumerator GetEnumerator();public System.Windows.Media.Media3D.Point3DCollection.Enumerator GetEnumerator ();member this.GetEnumerator : unit -> System.Windows.Media.Media3D.Point3DCollection.EnumeratorPublic Function GetEnumerator () As Point3DCollection.EnumeratorZwraca
Moduł wyliczający, który może iterować po kolekcji.
Uwagi
Moduły wyliczające zezwalają tylko na odczytywanie danych w kolekcji. Moduły wyliczania nie mogą służyć do modyfikowania podstawowej kolekcji.
Początkowo moduł wyliczający jest umieszczony przed pierwszym elementem w kolekcji. W tej pozycji wywołanie Current zgłasza wyjątek. W związku z tym należy wywołać metodę MoveNext , aby przejść do pierwszego elementu kolekcji przed odczytaniem wartości Current.
Funkcja Current zwraca ten sam obiekt do momentu wywołania metody MoveNext lub Reset . MoveNext ustawia wartość Current na następny element.
Po przekazaniu końca kolekcji moduł wyliczający jest umieszczony po ostatnim elemencie w kolekcji, a wywołanie metody MoveNext zwraca wartość false. Jeśli ostatnie wywołanie funkcji MoveNext zwróciło wartość false, wywołanie funkcji Current zgłasza wyjątek. Aby ponownie ustawić wartość Current na pierwszy element kolekcji, możesz wywołać polecenie Resetuj, a następnie pozycję MoveNext.
Moduł wyliczający zachowuje ważność tak długo, jak długo kolekcja pozostaje niezmieniona. Jeśli w kolekcji zostaną wprowadzone zmiany, takie jak dodawanie, modyfikowanie lub usuwanie elementów, moduł wyliczający jest nieodwracalnie unieważniany, a następne wywołanie metody MoveNext lub Reset zgłasza wyjątek InvalidOperationException. Jeśli kolekcja zostanie zmodyfikowana między elementem MoveNext i Current, funkcja Current zwróci element ustawiony na , nawet jeśli moduł wyliczający jest już unieważniony.
Moduł wyliczający nie ma wyłącznego dostępu do kolekcji, w związku z tym wyliczanie w kolekcji nie jest wewnętrznie procedurą odporną na wielowątkowość. Nawet w przypadku synchronizacji kolekcji inne wątki mogą nadal modyfikować kolekcję, co powoduje zgłoszenie wyjątku przez moduł wyliczający. Aby zagwarantować bezpieczeństwo wątków podczas wyliczania, można zablokować kolekcję podczas całego procesu wyliczania albo rejestrować wyjątki wynikłe ze zmian wprowadzanych przez inne wątków.
