WorkflowApplication.Unload 方法

定義

命名空間:

System.Activities

組件:

System.Activities.dll

保存或卸載工作流程執行個體。

多載

Unload(TimeSpan)	保存與卸載使用指定逾時間隔的工作流程執行個體。
Unload()	保存或卸載工作流程執行個體。

備註

根據預設，卸載作業必須在 30 秒內完成，否則會擲回 TimeoutException。

如果先前已從持續性載入工作流程執行個體，則會使用用來載入工作流程的相同 InstanceStore 做為保存。 如果工作流程已建立但尚未保存，則必須在呼叫這個方法之前設定 InstanceStore，否則呼叫這個方法時會擲回 InvalidOperationException。

Unload(TimeSpan)

保存與卸載使用指定逾時間隔的工作流程執行個體。

public:
 void Unload(TimeSpan timeout);

public void Unload (TimeSpan timeout);

member this.Unload : TimeSpan -> unit

Public Sub Unload (timeout As TimeSpan)

參數

timeout

TimeSpan

卸載作業必須在作業取消並擲回 TimeoutException 前完成的間隔。

範例

在這個範例中，工作流程已閒置而且主應用程式正等候使用者輸入。 如果使用者選擇卸載，就會呼叫 Unload。 如果呼叫成功，就會保存工作流程並從記憶體中卸載工作流程。

// single interaction with the user. The user enters a string in the console and that
// string is used to resume the ReadLine activity bookmark
static void Interact(WorkflowApplication application, AutoResetEvent resetEvent)
{
    Console.WriteLine("Workflow is ready for input");
    Console.WriteLine("Special commands: 'unload', 'exit'");

    bool done = false;
    while (!done)
    {
        Console.Write("> ");
        string s = Console.ReadLine();
        if (s.Equals("unload"))
        {
            try
            {
                // attempt to unload will fail if the workflow is idle within a NoPersistZone
                application.Unload(TimeSpan.FromSeconds(5));
                done = true;
            }
            catch (TimeoutException e)
            {
                Console.WriteLine(e.Message);
            }
        }
        else if (s.Equals("exit"))
        {
            application.ResumeBookmark("inputBookmark", s);
            done = true;
        }
        else
        {
            application.ResumeBookmark("inputBookmark", s);
        }
    }
    resetEvent.WaitOne();
}

備註

如果先前已從持續性載入工作流程執行個體，則會使用用來載入工作流程的相同 InstanceStore 做為保存。 如果工作流程已建立但尚未保存，則必須在呼叫這個方法之前設定 InstanceStore，否則呼叫這個方法時會擲回 InvalidOperationException。

Unload()

保存或卸載工作流程執行個體。

public:
 void Unload();

public void Unload ();

member this.Unload : unit -> unit

Public Sub Unload ()

範例

在這個範例中，工作流程已閒置而且主應用程式正等候使用者輸入。 如果使用者選擇卸載，就會呼叫 Unload。 如果呼叫成功，就會保存工作流程並從記憶體中卸載工作流程。

// single interaction with the user. The user enters a string in the console and that
// string is used to resume the ReadLine activity bookmark
static void Interact(WorkflowApplication application, AutoResetEvent resetEvent)
{
    Console.WriteLine("Workflow is ready for input");
    Console.WriteLine("Special commands: 'unload', 'exit'");

    bool done = false;
    while (!done)
    {
        Console.Write("> ");
        string s = Console.ReadLine();
        if (s.Equals("unload"))
        {
            try
            {
                // attempt to unload will fail if the workflow is idle within a NoPersistZone
                application.Unload(TimeSpan.FromSeconds(5));
                done = true;
            }
            catch (TimeoutException e)
            {
                Console.WriteLine(e.Message);
            }
        }
        else if (s.Equals("exit"))
        {
            application.ResumeBookmark("inputBookmark", s);
            done = true;
        }
        else
        {
            application.ResumeBookmark("inputBookmark", s);
        }
    }
    resetEvent.WaitOne();
}

備註

根據預設，卸載作業必須在 30 秒內完成，否則會擲回 TimeoutException。

如果先前已從持續性載入工作流程執行個體，則會使用用來載入工作流程的相同 InstanceStore 做為保存。 如果工作流程已建立但尚未保存，則必須在呼叫這個方法之前設定 InstanceStore，否則呼叫這個方法時會擲回 InvalidOperationException。