等候輸入活動

本主題僅適用於 Windows Workflow Foundation 4。

此範例會示範如何在工作流程中建立具名的書籤。Windows Workflow Foundation (WF) 不會提供宣告式書籤建立的活動。 因此，當您想要在工作流程中建立書籤時，您必須撰寫可建立書籤的自訂活動。 此範例中定義的 WaitForInput 活動會提供這個功能，所以使用者可在工作流程中以宣告方式建立書籤。

這個範例中的專案

專案名稱	說明	主要檔案
WaitForInput	包含 WaitForInput 活動和其設計工具	WaitForInput.cs WaitForInput 活動定義。
		WaitForInputDesigner.xaml WaitForInput 活動的自訂設計工具。
		TypeToFirstGenericArgumentConverter.cs WPF 型別轉換子，用來在設計工具內更新活動的泛型型別。
WaitForInputTestClient	範例用戶端應用程式，可透過工作流程設計工具來設定及執行使用幾個 WaitForInput 活動的工作流程。	Sequence1.xaml 使用 WaitForInput 活動的循序工作流程。
		Program.cs 執行 Sequence1.xaml 中定義的工作流程執行個體。

WaitForInput 活動

WaitForInput 活動會在工作流程中建立具名的書籤。 此書籤會等候信號，並接收其設定之型別的資料。 當書籤繼續之後，傳入工作流程的資料可透過 Result 屬性來使用。

WaitForInput 活動衍生自 NativeActivity 類別，因為它必須建立只能透過 NativeActivityContext 類別存取的書籤。

此活動有三個套用的屬性，可繫結設計工具、加入可以更新的泛型引數功能，以及將預設泛型型別設定為字串。 此活動也有列於下表的引數。

名稱	型別	說明
TResult	泛型引數 (TResult)	書籤的型別。 這是當書籤繼續時要傳遞給書籤的資料型別。
BookmarkName	InArgument<字串>	書籤的名稱。
結果	InArgument<TResult>	當書籤繼續時傳遞給活動的資料。

WaitForInput 活動設計工具

WaitForInput 活動設計工具會在 WaitForInputDesigner.xaml 檔案中實作。 WaitForInput 活動和它的設計工具會包含在相同的組件中。 下圖顯示工具箱中某個分類的 WaitForInput 活動，該分類的名稱與組件相同。

下圖顯示 WaitForInput 設計工具。 因為 WaitForInput 活動非常基本，所以設計工具允許直接在設計工具介面中設定它的所有引數。

若要使用這個範例

1. 使用 Visual Studio 2010 開啟 WaitForInput.sln 檔。

2. 若要建置此方案，請按 F6。

3. 若要啟動範例而不執行偵錯，請按 CTRL+F5。

注意：
這些範例可能已安裝在您的電腦上。 請先檢查下列 (預設) 目錄，然後再繼續。 <InstallDrive>:\WF_WCF_Samples 如果此目錄不存在，請移至用於 .NET Framework 4 的 Windows Communication Foundation (WCF) 與 Windows Workflow Foundation (WF) 範例 (英文)，以下載所有 Windows Communication Foundation (WCF) 和 WF 範例。 此範例位於下列目錄。 <InstallDrive>:\WF_WCF_Samples\WF\Scenario\ActivityLibrary\WaitForInput