ParallelForEach 活動會列舉集合的項目，並且平行執行集合中各個項目的內嵌陳述式，而這是同一個執行緒上的非同步處理。 如果預期此活動的子活動會進入閒置狀態，請使用這個流量控制活動代替 Sequence 活動。
ParallelForEach 活動有一個 CompletionCondition 屬性，其中包含使用者指定的 Visual Basic 運算式。 在各個分支完成之後，ParallelForEach 活動會評估這個屬性。 如果評估為 true，則 ParallelForEach 活動會完成，不會執行其他分支。 如果 CompletionCondition 評估不是 true，則 ParallelForEach 活動會在所有子活動都已完成時才完成。
ParallelForEach<T> 活動
ParallelForEach 會列舉其值，並且為列舉的每一個值排程 Body。 只會排程 Body。 主體執行的方式取決於 Body 是否變成閒置。
如果 Body 沒有變成閒置，就會依相反順序執行，因為排程的活動會做為一個堆疊處理，所以最後排程的活動會最先執行。 例如，如果您在 ParallelForEach 中有 {1,2,3,4} 集合，並且使用 WriteLine 做為主體將值寫出。 主控台會有 4, 3, 2, 1 列印出來。 這是因為 WriteLine 沒有變成閒置，所以在排程 4 WriteLine 活動之後，就會使用堆疊行為來執行 (先進後出)。
但是，如果您在 Body 中有活動可以變成閒置，像是 Receive 活動或 Delay 活動。 那麼，則不需要等候這些完成。ParallelForEach 會移至下一個排程的主體活動，且會嘗試執行此活動。 如果該活動也變成閒置，ParallelForEach 就會再移至下一個主體活動。
使用 ParallelForEach<T> 活動設計工具
[ParallelForEach<T>] 活動設計工具位於 [工具箱] 的 [控制流程] 類別中，若要存取，請按一下 工作流程設計工具 左側的 [工具箱] 索引標籤 (也可以從 [檢視] 功能表選取 [工具列]，或是按 CTRL+ALT+X)。
[ParallelForEach<T>] 活動設計工具可以從 [工具箱] 拖曳出來，放到 工作流程設計工具 介面上通常用來放置活動的任一處，例如在某個 [序列] 活動設計工具內部。 放進 工作流程設計工具 之後，就會建立 ParallelForEach 活動，此活動預設包含 ParallelForEach<Int32>. 的DisplayName。
工作流程設計工具中的 ParallelForEach<T> 屬性
下表顯示最為實用的 ParallelForEach 活動屬性，並且說明它們在設計工具中的使用方式。
| 屬性名稱 | 必要 | 使用方式 |
|---|---|---|
DisplayName |
False |
指定活動設計工具在標頭中的易記顯示名稱。 預設值為 ParallelForEach<Int32>。 此值可在 [屬性] 方格中編輯，或是直接在活動設計工具標頭上編輯。 |
Body |
False |
集合中每個項目要執行的活動。 若要加入 Body 活動，請從工具箱拖出一個活動，放進 [ParallelForEach<T>] 活動設計工具的 [本文] 方塊，加上提示文字「在此置放活動」。 |
TypeArgument |
True |
泛型參數 T 指定的 Values 集合中項目的型別。 依預設，TypeArgument 會設為 Int32。 若要變更 [ParallelForEach<T>] 活動設計工具中的型別 T，請變更屬性方格中 [TypeArgument] 下拉式方塊的值。 |
Values |
True |
要重複項目的集合。 若要設定 Values，請在有「輸入 VB 運算式」提示文字的方塊中，於 [ForEach<T>] 活動設計工具上的 [值] 方塊中輸入 Visual Basic 運算式，或是在 [屬性] 視窗中的 [值] 方塊內輸入。 |
CompletionCondition |
在每個反覆運算完成之後評估。 如果評估為 true，則會取消已排程的擱置中反覆運算。 如果並未設定此屬性，則會執行所有已排程的陳述式，直到完成為止。 |
依預設，迴圈 Iterator 會命名為 item。 您可以在 [ParallelForEach<T>] 活動設計工具的 [ForEach] 方塊中變更 Iterator 變數的名稱。 迴圈 Iterator 可用在 ParallelForEach 活動子系中的運算式。
另請參閱
概念
Sequence 活動設計工具
Parallel 活動設計工具