StringCollection.GetEnumerator Метод

Определение

Пространство имен:

System.Collections.Specialized

Сборки:

System.dll, System.Collections.Specialized.dll

Сборка:

System.Collections.Specialized.dll

Сборка:

System.dll

Сборка:

netstandard.dll

Возвращает объект StringEnumerator, осуществляющий перебор StringCollection.

public:
 System::Collections::Specialized::StringEnumerator ^ GetEnumerator();

public System.Collections.Specialized.StringEnumerator GetEnumerator ();

member this.GetEnumerator : unit -> System.Collections.Specialized.StringEnumerator

Public Function GetEnumerator () As StringEnumerator

Возвращаемое значение

StringEnumerator

Новый объект StringEnumerator для StringCollection.

Комментарии

Инструкция foreach языка C# (for each в Visual Basic) позволяет скрыть сложный механизм перечислителей. Поэтому рекомендуется вместо непосредственного использования перечислителя применять ключевое слово foreach.

Перечислители могут использоваться для чтения данных в коллекции, но не для ее изменения.

Изначально перечислитель располагается перед первым элементом коллекции. Метод Reset также переводит перечислитель в эту позицию. В этой позиции значение свойства Current не определено. Поэтому необходимо вызвать метод MoveNext, чтобы переместить перечислитель к первому элементу коллекции до считывания значения свойства Current.

Current возвращает тот же объект, пока не будет вызван метод MoveNext или Reset. MoveNext задает Current в качестве значения для следующего элемента.

Если MoveNext передает конец коллекции, перечислитель позиционируется после последнего элемента в коллекции и MoveNext возвращается false. Если перечислитель находится в этой позиции, последующие вызовы MoveNext для возврата falseтакже. Если последний обратный вызов MoveNext возвращен false, Current не определен. Чтобы снова задать в качестве значения свойства Current первый элемент коллекции, можно последовательно вызвать методы Reset иMoveNext.

Перечислитель является допустимым до тех пор, пока коллекция остается неизменной. Если в коллекцию вносятся изменения, например добавляются, изменяются или удаляются элементы, перечислитель становится недействительным без возможности восстановление, а его поведение не определено.

Перечислитель не имеет монопольного доступа к коллекции, поэтому перечисление элементов коллекции само по себе не является потокобезопасной процедурой. Чтобы гарантировать потокобезопасность, можно заблокировать коллекцию на время всего перечисления. Чтобы разрешить доступ к коллекции из нескольких потоков для чтения и записи, необходимо реализовать собственную синхронизацию.

Этот метод является операцией O(1).

См. также раздел

• StringEnumerator
• IEnumerator