WorkFlow 簡介

Windows Workflow Foundation 是在 VS2005 , 也就是 .NET Framework 3.0 時代才被加入的一個功能。 它被整合在 .NET Framework 之中，用來協助在應用程式中開發與工作流程相關的功能。 搭配 VS 的圖型化設計介面，讓您可以在 Windows 上快速建置支援工作流程的應用程式。

WF 架構簡介

Windows Workflow Foundation 架構主要分份兩個部份：一是工作流程內容，另一是執行工作流程的執行階段引擎。

WF4 專案範本

Visual Studio 2010 提供四種 WF 範本：

定義活動與工作流程（Activities and Workflows）

活動（Activities）

在 WF 中，「工作流程」中的每一個關卡，都稱為一個「活動（Activities）」。「活動」是「工作流程」中的基礎單元。 在工具箱中，有各種現成的活動元件可以使用，你可以使用這些元件來建構你的工作流程，也可以使用自行開發的自訂活動來建構你的工作流程。

下圖是一個簡單工作流程，其中包含了三個活動。

下圖是一個較複雜的計算機的工作流程，其中包含了多個活動。

工作流程（Workflows）

Visual Studio 提供了各式活動，將這些活動靈活組合運用，你就可以設計出許多程式所需要的工作流程。

建立工作流程實體

定義好工作流程，你必須在應用程式中建立該工作流程的實體，以執行工作流程中的內容。 .NET Framework 提供以下幾種方式來建立工作流程實體。

使用 WorkflowInvoker 類別

WorkflowInvoker 類別提供較簡易但功能較少的方法來建立工作流程實體。 使用這個方法建立的工作流桯，當啟動流程後，就會一直執行到完成為止。

同步方式執行

若要以同步方式執行工作流程，只要叫用靜態方法 WorkflowInvoker.Invoke 即可。

WorkflowInvoker.Invoke(new wf_SayHello());

非同步方式執行

這個類別也支援非同步方式執行工作流桯，不過它必須由 WorkflowInvoker 實體類別的 InvokeAsync 方法啟動。

WorkflowInvoker invoker = new WorkflowInvoker(new wf_SayHello());
    invoker.InvokeAsync();
    invoker.InvokeCompleted += new EventHandler＜InvokeCompletedEventArgs＞(workerInvokeCompleted);

使用 WorkflowApplication 類別

WorkflowApplication 類別提供較多的方法，可以用來控制工作流程。 例如使用書籤(Bookmark)來繼續工作流程中的活動，或者在應用程式中接收工作流程的事件通知等等。 你可以使用以下幾個方法來控制工作流程：

• Run ：開始或繼續執行工作流程執行個體。
• Abort ：通知工作流程執行階段此工作流程執行個體應該中止。
• Cancel ：取消工作流程執行個體。
• Load ：Loads a workflow instance from an instance store.
• Persist ：將工作流程執行個體保存到執行個體存放區。
• Terminate ：保存或卸載工作流程執行個體。
• Unload ：保存或卸載工作流程執行個體。

//TODO: 1.建立工作流程實體
    wfInstance = new WorkflowApplication(new Calculator());
                

    //TODO: 2.建立工作流程完成時所要執行的方法委派
    wfInstance.Completed = delegate(WorkflowApplicationCompletedEventArgs args)
    {

        Dispatcher.BeginInvoke(new Action<decimal>(UpdateUI), args.Outputs["Result"]);

        wfInstance = null;
    };

    //TODO: 3.啟動工作流程
    wfInstance.Run();

建立 Sequence 工作流程

建立自訂活動（Code Activity）

工作流程也可當做活動

當你定義好一個工作流程，在專案建置之後，你可以在工具箱中發現，每個工作流程都變成一個可用的活動，被歸類在同一個工具群組之中。如下圖：

所以說，如果你有一段流程會在很多工作流程中使用，你可以將這一段流程獨立到一個工作流程，再建立成活動，就可以在其他的工作流程中重複使用這一段流程。

繼承 CodeActivity 類別

你也可以將某些會重複執行的程式碼設計成活動，讓不同的工作流程都可以直接使用。例如存取資料庫的程式碼。 這一類型的活動，就稱「程式碼活動」。在 workflow 專案的項目中就有這個範本。

「程式碼活動」本身就是一個類別檔，只不過繼承了 CodeActivity 類別。 你只要將工作流程要用到的程式碼撰寫在 Execute 方法中即可。

public sealed class ca_ShowMessage : CodeActivity
{
    // 定義字串型別的活動輸入引數
    public InArgument<string> Text { get; set; }

    // 如果您的活動要傳回值，請從 CodeActivity<TResult> 衍生該值，
    // 並從 Execute 方法傳回該值。
    protected override void Execute(CodeActivityContext context)
    {
        // 取得 Text 輸入引數的執行階段值
        string text = context.GetValue(this.Text);
        MessageBox.Show(text);   
    }
}

繼承 NativeActivity 類別

繼承 CodeActivity 類別所產生的程式碼活動，功能較少。如果需要在自訂的程式碼活動中使用書籤，或是存取執行環境中的完整功能，就必須改為繼承 NativeActivity 類別。

public sealed class na_RetrieveString : NativeActivity<string>
{
    // 定義活動的輸入引數
    public InArgument<string> BookmarkName { get; set; }

    protected override void Execute(NativeActivityContext context)
    {
        context.CreateBookmark(BookmarkName.Get(context), new BookmarkCallback(ReturnValue));
    }

    public void ReturnValue(NativeActivityContext context, Bookmark bookmark, object obj)
    {
        Result.Set(context, (string)obj);
    }

    protected override bool CanInduceIdle
    {
        get {return true;}
    }
}

建立書籤（Bookmark）

如果你的工作流程必須暫時停止，等待外部應用程式傳送訊號進來之後再繼續執行，這時候就必須使用到書籤。 所以「書籤」就是流程暫停後再繼續執行的點。 要設計「書籤」，你必須自訂一個繼承 NativeActivity 類別的「程式碼活動」。

建立書籤步驟：

1. 建立繼承 NativeActivity 類別的「程式碼活動」。
2. 使用 CreateBookmark 方法建立書籤。
3. 覆寫 CanIncludeIdle 屬性。

// 1. 繼承 NativeActivity 類別
    public sealed class na_RetrieveString : NativeActivity<string>
    {
        public InArgument<string> BookmarkName { get; set; }

        protected override void Execute(NativeActivityContext context)
        {
            // 2. 使用 CreateBookmark 方法建立書籤
            context.CreateBookmark(BookmarkName.Get(context), new BookmarkCallback(ReturnValue));
        }

        public void ReturnValue(NativeActivityContext context, Bookmark bookmark, object obj)
        {
            Result.Set(context, (string)obj);
        }

        // 3. 覆寫 CanIncludeIdle 屬性
        protected override bool CanInduceIdle
        {
            get {return true;}
        }
    }

建立 Flowchart 工作流程

通常使用 Sequence 活動可以用來建立較簡單且循序執行的工作流程，但是如果要建立較複雜的流程，例如計算機流程或者表單系統流程等，就必須使用 Flowchart 活動。

• Windows Workflow 概觀
• WF4 第一課 – 初探
• WF4 第二課 – Hello WF 4
• WF4 第三課 – 設計Code Activity
• WF4 第四課 – 動態執行流程
• WF4 第五課 – 測試WF流程
• WF4 第六課 – WorkflowApplication
• WF4 第七課 – If/Else判斷邏輯
• WF4 第八課 – 錯誤處理
• WF4 第九課 – Activity Designer
• WF4 第十課 – 自訂的WF設計器
• .NET 4.5 中 Windows Workflow Foundation 的新功能