Metoda IDTSCustomPropertyCollection100.GetEnumerator
Zwraca moduł wyliczający których może iterować przez IDTSCustomPropertyCollection100.
Przestrzeń nazw: Microsoft.SqlServer.Dts.Pipeline.Wrapper
Zestaw: Microsoft.SqlServer.DTSPipelineWrap (w Microsoft.SqlServer.DTSPipelineWrap.dll)
Składnia
'Deklaracja
Function GetEnumerator As IEnumerator
'Użycie
Dim instance As IDTSCustomPropertyCollection100
Dim returnValue As IEnumerator
returnValue = instance.GetEnumerator()
IEnumerator GetEnumerator()
IEnumerator^ GetEnumerator()
abstract GetEnumerator : unit -> IEnumerator
function GetEnumerator() : IEnumerator
Wartość zwracana
Typ: System.Collections.IEnumerator
Elemencie IEnumerator, który można iterować w kolekcja właściwość niestandardowych.
Implementacje
Uwagi
Moduły wyliczające Zezwalaj tylko odczytywanie danych kolekcja.Moduły wyliczające nie można modyfikować kolekcja podstawowej.
Początkowo moduł wyliczający jest umieszczony przed pierwszym elementem kolekcja.Resetuj również powoduje powrót do tej pozycji moduł wyliczający.Co to położenie, wywołując bieżącego zgłasza wyjątek.Dlatego należy wywołać MoveNext aby przejść do pierwszego elementu kolekcja przed odczytywania wartości moduł wyliczający bieżącego.
Bieżący zwraca ten sam obiekt, aż do MoveNext lub zresetować jest wywoływana.MoveNext ustawia bieżącego do następnego elementu.
Po zakończeniu zbierania jest moduł wyliczający jest pozycjonowane za ostatnim elementem kolekcja i wywoływania MoveNext zwraca false.Jeśli wywołanie ostatniego MoveNext zwrócił false, wywołujący bieżącego zgłasza wyjątek.Aby zestaw bieżącego do pierwszego elementu kolekcja ponownie można wywołać Rezestaw następuje MoveNext.
Moduł wyliczający zachowuje ważność tak długo, jak długo kolekcja pozostaje niezmieniony.Jeśli zmian do kolekcja, takie jak dodawanie, modyfikowanie lub usuwanie elementów, moduł wyliczający jest nieodwracalnie unieważnione i wywołanie następnego MoveNext lub zresetować generuje InvalidOperationException.Kolekcja jest modyfikowany między MoveNext i bieżącego, bieżącego zwraca element, który jest zestaw , nawet jeśli moduł wyliczający jest już unieważnione.
Moduł wyliczający nie mieć wyłączny dostęp do kolekcja; Wyliczanie kolekcja za bardzo nie jest więc procedurę bezpiecznego wątek.Nawet kiedy kolekcja jest synchronizowane, inne wątki nadal można zmodyfikować kolekcji, która powoduje, że moduł wyliczający w celu wygenerowania wyjątku.W celu zagwarantowania bezpieczeństwa wątek podczas wyliczania, można albo blokada kolekcja podczas wyliczania całej lub połowów wyjątki wynikające ze zmian wprowadzonych przez innych wątków.