ReadOnlySpan<T>.Enumerator 结构

定义

public: value class ReadOnlySpan<T>::Enumerator : System::Collections::Generic::IEnumerator<T>

public: value class ReadOnlySpan<T>::Enumerator

public ref struct ReadOnlySpan<T>.Enumerator : System.Collections.Generic.IEnumerator<T>

public ref struct ReadOnlySpan<T>.Enumerator

type ReadOnlySpan<'T>.Enumerator = struct
    interface IEnumerator<'T>
    interface IEnumerator
    interface IDisposable

type ReadOnlySpan<'T>.Enumerator = struct

Public Structure ReadOnlySpan(Of T).Enumerator
Implements IEnumerator(Of T)

Public Structure ReadOnlySpan(Of T).Enumerator

类型参数

继承

Object

ValueType

ReadOnlySpan<T>.Enumerator

实现

IEnumerator<T> IEnumerator IDisposable

注解

C# foreach c# 语言和 For Each...接下来构造Visual Basic隐藏枚举器的复杂性。 建议使用或For Each...Next建议直接foreach操作枚举器， 而不是直接操作枚举器。

最初，枚举器位于第一个元素之前 ReadOnlySpan<T>。 在此位置， Current 未定义。 在读取值Current之前，必须调用MoveNext枚举器将枚举器前进到第一项ReadOnlySpan<T>。

Current 返回相同的值，直到 MoveNext 调用为止。 MoveNext 设置为 Current .. 中的 ReadOnlySpan<T>下一项。

如果 MoveNext 传递末尾 ReadOnlySpan<T>， MoveNext 则 false返回。 当枚举器处于此状态时，后续调用 MoveNext 也会返回 false 且 Current 未定义。 不能再次设置为 Current 第一项 ReadOnlySpan<T> ;必须改为创建新的枚举器实例。

尽管在 ReadOnlySpan<T> 堆栈上分配了该数据，但 ReadOnlySpan<T> 指向的基础数据可能不是。 因此，通过 ReadOnlySpan<T> 枚举本质上不是线程安全的过程。 若要保证枚举期间的线程安全性，必须实现自己的同步。

与.NET中的一些其他枚举器结构不同，ReadOnlySpan<T>.Enumerator：

• 不实现 IEnumerator 或 IEnumerator<T> 接口。 这是因为 ReadOnlySpan<T>.Enumerator 是 ref 结构 ，不能装箱。

• 不包括方法 Reset ，该方法可以将枚举器设置为其初始位置，然后再在范围中的第一个元素之前。 （该方法 IEnumerator.Reset() 必须作为接口的一部分实现，但大多数实现者要么引发异常，要么不提供任何实现。