WF4.0 基礎篇(17)：Bookmark 書籤機制實現長期執行與外部觸發

Bookmark (書籤) 是 WF4.0 實現「暫停等待外部信號」的核心機制。活動建立書籤後，工作流進入 Idle 狀態，宿主可透過 ResumeBookmark 傳入資料喚醒流程繼續執行，支援無回傳值與泛型回傳值兩種模式。

無回傳值書籤活動

public sealed class NoResultBookmark : NativeActivity
{
    public InArgument<string> BookmarkName { get; set; }
    protected override bool CanInduceIdle => true;
    protected override void Execute(NativeActivityContext context)
    {
        context.CreateBookmark(context.GetValue(BookmarkName));
        Console.WriteLine($"建立書籤: {context.GetValue(BookmarkName)}");
    }
}

流程與結果：

有回傳值書籤活動 (泛型)

public sealed class ResultBookmark<T> : NativeActivity<T>
{
    public InArgument<string> BookmarkName { get; set; }
    protected override bool CanInduceIdle => true;
    protected override void Execute(NativeActivityContext context)
    {
        context.CreateBookmark(context.GetValue(BookmarkName), BookmarkCallback);
    }
    void BookmarkCallback(NativeActivityContext context, Bookmark bookmark, object obj)
    {
        this.Result.Set(context, (T)obj);
    }
}

流程與結果：

進階場景：Parallel 中使用書籤 (並行等待多個外部信號)

流程：Parallel 分支各建立不同名稱書籤，宿主可任意順序喚醒。

結果：

ParallelForEach 中使用書籤 (集合並行處理)

參數/變數/流程：

結果：每個集合項目並行建立書籤，宿主逐一喚醒。

ForEach 中使用書籤 (序列處理)

將 ParallelForEach 換為 ForEach，書籤按序建立與喚醒。

範例下載：BookmarkSample.rar