HOW TO：啟用工作流程與工作流程服務的 SQL 持續性

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

本主題描述如何設定 SQL 工作流程執行個體存放區功能，以程式設計方式或使用組態檔來啟用工作流程與工作流程服務的持續性。使用 SQL 工作流程執行個體存放區功能之前，請建立一個讓此功能用於保存工作流程執行個體的資料庫。.NET Framework 4 安裝程式會將與 SQL 工作流程執行個體存放區功能相關聯的 SQL 指令碼檔複製至 %WINDIR%\Microsoft.NET\Framework\v4.xxx\SQL\EN 資料夾。針對 SQL Server 2005 或 SQL Server 2008 資料庫執行這些指令碼檔，且這個資料庫可供 SQL 工作流程執行個體存放區用來保存工作流程執行個體。先執行 SqlWorkflowInstanceStoreSchema.sql 檔，然後再執行 SqlWorkflowInstanceStoreLogic.sql 檔。

注意：
若要清除持續性資料庫來擁有乾淨的資料庫，請依照下列順序執行 %WINDIR%\Microsoft.NET\Framework\v4.xxx\SQL\EN 中的指令碼。 SqlWorkflowInstanceStoreSchema.sql SqlWorkflowInstanceStoreLogic.sql

注意：
如果您並未建立持續性資料庫，則當主機嘗試保存工作流程時，SQL 工作流程執行個體存放區功能就會擲回與下列其中一個相似的例外狀況。 System.Data.SqlClient.SqlException：找不到預存程序 'System.Activities.DurableInstancing.CreateLockOwner'

下列各節描述如何使用 SQL 工作流程執行個體存放區來啟用工作流程與工作流程服務的持續性。如需詳細資訊如需 SQL 工作流程執行個體存放區屬性的詳細資訊，請參閱 SQL 工作流程執行個體存放區的屬性。

啟用使用 WorkflowApplication 之自我裝載工作流程的持續性

您可以使用 SqlWorkflowInstanceStore 物件模型，以程式設計方式啟用使用 WorkflowApplication 之自我裝載工作流程的持續性。下列程序包含執行此作業的步驟。

若要啟用自我裝載工作流程的持續性

1. 加入 System.Activites.DurableInstancing.dll 的參考。

2. 在原始程式檔最上方現有的 "using" 陳述式後方，加入下列陳述式。

   using System.Activities.DurableInstancing;
   

3. 建構 SqlWorkflowInstanceStore 並將它指派給 WorkflowApplication 的 InstanceStore，如下列程式碼範例所示。

   SqlWorkflowInstanceStore store = 
       new SqlWorkflowInstanceStore("Server=.\\SQLEXPRESS;Initial Catalog=Persistence;Integrated Security=SSPI");
   
   WorkflowApplication wfApp =
       new WorkflowApplication(new Workflow1());
   
   wfApp.InstanceStore = store;
   

   注意：
   視 SQL Server 版本而定，連接字串的伺服器名稱可能有所不同。

4. 叫用 WorkflowApplication 物件上的 Persist 方法以保存工作流程，或叫用 Unload 以保存及卸載工作流程。您也可以處理由 WorkflowApplication 物件引發的 PersistableIdle 事件，並傳回 PersistableIdleAction 的適當 (Persist 或 Unload) 成員。

   wfApp.PersistableIdle = delegate(WorkflowApplicationIdleEventArgs e)
   {
       return PersistableIdleAction.Persist;
   };
   

注意：
請參閱持續性中的持續工作流程應用程式範例以取得使用 SqlWorkflowInstanceStore 來啟用工作流程持續性的範例，並參閱使用者入門教學課程的 HOW TO：建立與執行長期執行的工作流程步驟來取得逐步指示。

啟用使用 WorkflowServiceHost 之自我裝載工作流程服務的持續性

您可以使用 SqlWorkflowInstanceStoreBehavior 類別或 DurableInstancingOptions 類別，啟用以程式設計方式使用 WorkflowServiceHost 之自我裝載工作流程服務的持續性。

使用 SqlWorkflowInstanceStoreBehavior 類別

以下程序包含使用 SqlWorkflowInstanceStoreBehavior 類別以啟用自我裝載工作流程服務之持續性的步驟。

若要啟用使用 SqlWorkflowInstanceStoreBehavior 的持續性

1. 加入 System.ServiceModel.dll 的參考。

2. 在原始程式檔最上方現有的 "using" 陳述式後方，加入下列陳述式。

   using System.ServiceModel.Activities.Description;
   

3. 建立 WorkflowServiceHost 的執行個體，並加入工作流程服務的端點。

   WorkflowServiceHost host = new WorkflowServiceHost(new CountingWorkflow(), new Uri(hostBaseAddress));
   host.AddServiceEndpoint("ICountingWorkflow", new BasicHttpBinding(), "");
   

4. 建構 SqlWorkflowInstanceStoreBehavior 物件並設定該行為物件的屬性。

   SqlWorkflowInstanceStoreBehavior instanceStoreBehavior = new SqlWorkflowInstanceStoreBehavior(connectionString);
   instanceStoreBehavior.HostLockRenewalPeriod = new TimeSpan(0, 0, 5);
   instanceStoreBehavior.InstanceCompletionAction = InstanceCompletionAction.DeleteAll;
   instanceStoreBehavior.InstanceLockedExceptionAction = InstanceLockedExceptionAction.AggressiveRetry;
   instanceStoreBehavior.InstanceEncodingOption = InstanceEncodingOption.GZip;
   instanceStoreBehavior.RunnableInstancesDetectionPeriod = new TimeSpan("00:00:02");
   host.Description.Behaviors.Add(instanceStoreBehavior);
   

5. 開啟工作流程服務主機。

   host.Open();
   

注意：
請參閱持續性中的內建組態範例，以取得使用 SqlWorkflowInstanceStoreBehavior 類別啟用工作流程服務持續性的範例。

使用 DurableInstancingOptions 屬性

當套用 SqlWorkflowInstanceStoreBehavior 時，會將 WorkflowServiceHost 上的 DurableInstancingOptions.InstanceStore 設定為使用組態值建立的 SqlWorkflowInstanceStore 物件。您同樣可以使用程式設計方式，在不必使用 SqlWorkflowInstanceStoreBehavior 類別的情況下，設定 WorkflowServiceHost 的 DurableInstancingOptions 屬性，如下列程式碼範例所示。

workflowServiceHost.DurableInstancingOptions.InstanceStore = sqlInstanceStoreObject;

使用組態檔啟用使用 WorkflowServiceHost 之 WAS 裝載工作流程服務的持續性

您可以使用組態檔，啟用自我裝載或 Windows Process Activation Service (WAS) 裝載之工作流程服務的持續性。WAS 裝載的工作流程服務會使用 WorkflowServiceHost，如同自我裝載的工作流程服務一樣。

SqlWorkflowInstanceStoreBehavior 這個服務行為可讓您透過 XML 組態來方便地變更 SQL 工作流程執行個體存放區屬性。如果是 WAS 裝載的工作流程服務，請使用 Web.config 檔。下列組態範例示範如何使用組態檔中的 sqlWorkflowInstanceStore 行為項目來設定 SQL 工作流程執行個體存放區。

<serviceBehaviors>
    <behavior name="">
        <sqlWorkflowInstanceStore 
                    connectionString="Data Source=(local);Initial Catalog=DefaultPersistenceProviderDb;Integrated Security=True;Async=true"
                    instanceEncodingOption="GZip | None"
                    instanceCompletionAction="DeleteAll | DeleteNothing"
                    instanceLockedExceptionAction="NoRetry | BasicRetry |AggressiveRetry"
                    hostLockRenewalPeriod="00:00:30" 
                    runnableInstancesDetectionPeriod="00:00:05">

        <sqlWorkflowInstanceStore/>
    </behavior>
</serviceBehaviors>

如果您並未設定 connectionString 或 connectionStringName 屬性的值，SQL 工作流程執行個體存放區就會使用預設命名的連接字串 DefaultSqlWorkflowInstanceStoreConnectionString。

當套用 SqlWorkflowInstanceStoreBehavior 時，會將 WorkflowServiceHost 上的 DurableInstancingOptions.InstanceStore 設定為使用組態值建立的 SqlWorkflowInstanceStore 物件。您同樣可以使用程式設計方式，在不必使用服務行為項目的情況下，搭配 WorkflowServiceHost 來使用 SqlWorkflowInstanceStore。

workflowServiceHost.DurableInstancingOptions.InstanceStore = sqlInstanceStoreObject;

安全性 注意：
建議您不要將敏感資訊 (例如，使用者名稱和密碼) 儲存在 Web.config 檔案中。如果要將敏感資訊儲存在 Web.config 檔案中，則應使用檔案系統存取控制清單 (ACL) 來保護存取 Web.config 檔的安全性。此外，您也可以如使用受保護的組態加密組態資訊中所述，保護組態檔內組態值的安全性。

與 SQL 工作流程執行個體存放區功能相關的 Machine.config 項目

.NET Framework 4 安裝會將下列與 SQL 工作流程執行個體存放區功能相關的項目加入至 Machine.config 檔：

• 將以下行為延伸項目加入至 Machine.config 檔，這樣您就可以使用組態檔中的 <sqlWorkflowInstanceStore> 服務行為項目來設定服務的持續性。

  <configuration>
      <system.serviceModel>
          <extensions>
              <behaviorExtensions>
                  <add name="sqlWorkflowInstanceStore" type="System.Activities.DurableInstancing.SqlWorkflowInstanceStoreElement, System.Activities.DurableInstancing, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" />
              </behaviorExtensions>
          </extensions>
      <system.serviceModel>
  <configuration>