ManagementObjectCollection.IEnumerable.GetEnumerator Yöntem

Tanım

Ad Alanı:

System.Management

Bütünleştirilmiş Kod:

System.Management.dll

Paket:

System.Management v11.0.0-preview.4.26230.115

Kaynak:

ManagementObjectCollection.cs

aracılığıyla IEnumeratoryineleyen bir ManagementObjectCollection döndürür.

 virtual System::Collections::IEnumerator ^ System.Collections.IEnumerable.GetEnumerator() = System::Collections::IEnumerable::GetEnumerator;

System.Collections.IEnumerator IEnumerable.GetEnumerator();

abstract member System.Collections.IEnumerable.GetEnumerator : unit -> System.Collections.IEnumerator
override this.System.Collections.IEnumerable.GetEnumerator : unit -> System.Collections.IEnumerator

Function GetEnumerator () As IEnumerator Implements IEnumerable.GetEnumerator

Döndürülenler

IEnumerator

için IEnumeratorbirManagementObjectCollection.

Uygulamalar

GetEnumerator()

Açıklamalar

C# dilinin foreach deyimi (Visual Basic'da for each), numaralandırıcıların karmaşıklığını gizler. Bu nedenle, numaralandırıcıyı doğrudan işlemek yerine kullanılması foreach önerilir.

Numaralandırıcılar koleksiyondaki verileri okumak için kullanılabilir, ancak temel koleksiyonu değiştirmek için kullanılamaz.

Başlangıçta, numaralandırıcı koleksiyondaki ilk öğeden önce konumlandırılır. Reset ayrıca numaralandırıcıyı bu konuma geri getirir. Bu konumda çağrısı Current bir özel durum oluşturur. Bu nedenle, değerini MoveNextokumadan önce numaralandırıcıyı koleksiyonun ilk öğesine ilerletmek için çağrısında Current bulunmalısınız.

Currentveya MoveNext çağrılana kadar Reset aynı nesneyi döndürür. MoveNext bir sonraki öğeye ayarlar Current .

Koleksiyonun sonunu geçerse MoveNext , numaralandırıcı koleksiyondaki son öğeden sonra konumlandırılır ve MoveNext döndürür false. Numaralandırıcı bu konumda olduğunda, sonraki çağrıları MoveNext da döndürür false. döndürülen MoveNextson çağrı false ise çağrısı Current bir özel durum oluşturur. Koleksiyonun ilk öğesine yeniden ayarlamak Current için öğesini ve ardından Resetöğesini çağırabilirsinizMoveNext.

Bir numaralandırıcı, koleksiyon değişmediği sürece geçerli kalır. Koleksiyonda öğe ekleme, değiştirme veya silme gibi değişiklikler yapılırsa, numaralandırıcı geri alınamaz şekilde geçersiz kılınmış olur ve bir sonraki çağrısı veya MoveNextReset oluşturur InvalidOperationException. Koleksiyon ile MoveNextCurrent arasında Current değiştirilirse, numaralandırıcı zaten geçersiz kılınmış olsa bile, olarak ayarlandığı öğeyi döndürür.

Numaralandırıcının koleksiyona özel erişimi yoktur; bu nedenle, bir koleksiyonda numaralandırmak, iş parçacığı güvenli bir yordam değildir. Bir koleksiyon eşitlendiğinde bile, diğer iş parçacıkları yine de koleksiyonu değiştirebilir ve bu da numaralandırıcının bir özel durum oluşturmasına neden olur. Numaralandırma sırasında iş parçacığı güvenliğini garanti etmek için, tüm numaralandırma sırasında koleksiyonu kilitleyebilir veya diğer iş parçacıkları tarafından yapılan değişikliklerden kaynaklanan özel durumları yakalayabilirsiniz.

Bu yöntem bir O(1) işlemidir.