如何：使用 foreach 访问集合类（C# 编程指南）

C#的foreach需要类型继承IEnumerable或IEnumerable<T>

如何：使用 foreach 访问集合类（C# 编程指南）

Visual Studio 2015

其他版本



Visual Studio 2013

Visual Studio 2012

Visual Studio 2010

Visual Studio 2005

 

下面的代码示例演示如何编写可与
foreach 结合使用的非泛型集合类。该示例定义了字符串 tokenizer 类。

注意
此示例描述的是仅当您无法使用泛型集合类时才采用的推荐做法。有关如何实现支持 IEnumerable<T> 的类型安全的泛型集合类，请参见迭代器（C# 和 Visual Basic）。

在该示例中，以下代码段使用 Tokens 类通过“ ”和“-”分隔符将句子“This is a sample sentence.”分成若干标记。该代码然后使用
foreach 语句显示这些标记。

C#

复制

Tokens f = new Tokens("This is a sample sentence.", new char[] {' ','-'});

// Display the tokens.
foreach (string item in f)
{
System.Console.WriteLine(item);
}

在内部，Tokens 类使用数组存储这些标记。因为数组可实现

IEnumerator 和
IEnumerable，所以代码示例使用了数组的枚举方法（GetEnumerator、MoveNext、Reset
和
Current），而不是在 Tokens 类中定义这些方法。方法定义包括在该示例中，以明确如何定义它们以及每个定义的内容。

C#

复制

using System.Collections;

// Declare the Tokens class. The class implements the IEnumerable interface.
public class Tokens : IEnumerable
{
private string[] elements;

Tokens(string source, char[] delimiters)
{
// The constructor parses the string argument into tokens.
elements = source.Split(delimiters);
}

// The IEnumerable interface requires implementation of method GetEnumerator.
public IEnumerator GetEnumerator()
{
return new TokenEnumerator(this);
}

// Declare an inner class that implements the IEnumerator interface.
private class TokenEnumerator : IEnumerator
{
private int position = -1;
private Tokens t;

public TokenEnumerator(Tokens t)
{
this.t = t;
}

// The IEnumerator interface requires a MoveNext method.
public bool MoveNext()
{
if (position < t.elements.Length - 1)
{
position++;
return true;
}
else
{
return false;
}
}

// The IEnumerator interface requires a Reset method.
public void Reset()
{
position = -1;
}

// The IEnumerator interface requires a Current method.
public object Current
{
get
{
return t.elements[position];
}
}
}

// Test the Tokens class.
static void Main()
{
// Create a Tokens instance.
Tokens f = new Tokens("This is a sample sentence.", new char[] {' ','-'});

// Display the tokens.
foreach (string item in f)
{
System.Console.WriteLine(item);
}}
}
/* Output:
This
is
a
sample
sentence.
*/

在 C# 中，集合类不必通过实现
IEnumerable 和
IEnumerator 来与 foreach 兼容。如果此类具有所需的

GetEnumerator、MoveNext、Reset
和
Current 成员，则可与 foreach 结合使用。省略接口有一个好处：即，您可以比

Object 更为具体地定义 Current 的返回类型。这会提供类型安全。

例如，可更改上述示例中的以下行。

C#

复制

// Change the Tokens class so that it no longer implements IEnumerable.
public class Tokens
{
// . . .

// Change the return type for the GetEnumerator method.
public TokenEnumerator GetEnumerator()
{   }

// Change TokenEnumerator so that it no longer implements IEnumerator.
public class TokenEnumerator
{
// . . .

// Change the return type of method Current to string.
public string Current
{   }
}
}

由于 Current 返回字符串，因此编译器能够检测何时在
foreach 语句中使用了不兼容的类型，如以下代码所示。

C#

复制

// Error: Cannot convert type string to int.
foreach (int item in f)

省略
IEnumerable 和
IEnumerator 的缺点是：集合类不再与其他公共语言运行时语言的 foreach 语句或等效语句交互。

请参阅


System.Collections.Generic
C# 参考
C# 编程指南
数组（C# 编程指南）
集合（C# 和 Visual Basic）