foreach, in (C# 參考)

更新:2007 年 11 月

對於在陣列或物件集合中實作 System.Collections.IEnumerableSystem.Collections.Generic.IEnumerable<T> 介面的每個項目,foreach 陳述式會重複內嵌陳述式群組。foreach 陳述式是用來逐一查看集合,以取得所需的資訊,但是不能用來加入或移除來源集合的項目,以避免無法預期的副作用。如果您必須加入或移除來源集合的項目,請使用 for 迴圈。

內嵌陳述式繼續執行在陣列或集合中的每個項目。反覆查看項目完成在集合中的所有項目之後,程式控制權會轉移到 foreach 區塊之後的下一個陳述式。

您可以在 foreach 區塊內的任一位置使用 break 關鍵字中斷迴圈,或使用 continue 關鍵字跳至迴圈內的下一個反覆運算。

foreach 迴圈也可以由 gotoreturnthrow 陳述式結束。

如需 foreach 關鍵字及其程式碼範例的詳細資訊,請參閱下列主題:

在陣列上使用 foreach (C# 程式設計手冊)

HOW TO:使用 foreach 存取集合類別 (C# 程式設計手冊)

範例

在這個範例中,foreach 是用來顯示整數陣列的內容。

class ForEachTest
{
    static void Main(string[] args)
    {
        int[] fibarray = new int[] { 0, 1, 2, 3, 5, 8, 13 };
        foreach (int i in fibarray)
        {
            System.Console.WriteLine(i);
        }
    }
}
/*
Output:
0
1
2
3
5
8
13
*/

C# 語言規格

如需詳細資料,請參閱 C# 語言規格中的下列章節:

  • 5.3.3.16 Foreach 陳述式

  • 8.8.4 foreach 陳述式

請參閱

概念

C# 程式設計手冊

參考

C# 關鍵字

反覆運算陳述式 (C# 參考)

其他資源

C# 參考