持續性參與者

發行項
03/11/2024

持續性參與者可參與由應用程式主機所觸發的持續性作業 (「儲存」或「載入」)。 .NET Framework 4.6.1 隨附兩個您可用來建立持續性參與者的抽象類別：PersistenceParticipant 和 PersistenceIOParticipant。持續性參與者會衍生自這些類別的其中一個、實作感興趣的方法，然後將類別的執行個體加入至 WorkflowExtensions 上的 WorkflowServiceHost 集合。應用程式主機保存工作流程執行個體時，可能會尋找此類工作流程擴充功能，並且在適當的時間於持續性參與者上叫用適當的方法。

以下清單描述持續性子系統在不同階段的「保存」(儲存) 作業時所執行的工作。持續性參與者會用於第三與第四階段。如果參與者是 I/O 參與者 (同樣參與 I/O 作業的持續性參與者)，則此參與者會用於第六階段。

收集內建值，包含工作流程狀態、書籤、對應的變數以及時間戳記。
收集加入至與工作流程執行個體相關之擴充集合的所有持續性參與者。
叫用由所有持續性參與者實作的 CollectValues 方法。
叫用由所有持續性參與者實作的 MapValues 方法。
保存工作流程，或將工作流程儲存至持續性存放區中。
在所有持續性 I/O 參與者上叫用 BeginOnSave 方法。如果參與者並非 I/O 參與者，則會略過此工作。如果持續性的時段屬於交易性質，則交易會在 Transaction.Current 屬性中提供。
等候所有持續性參與者完成。如果所有參與者成功保存執行個體資料，則認可異動。

持續性參與者衍生自 PersistenceParticipant 類別，且可實作 CollectValues 和 MapValues 方法。持續性 I/O 參與者衍生自 PersistenceIOParticipant 類別，除了可實作 CollectValues 和 MapValues 方法之外，還可實作 BeginOnSave 方法。

每個階段都會先完成，再開始進行下一個階段。例如，在第一階段中，會先從 all 持續性參與者收集值。然後，會將在第一階段中收集到的所有值提供給第二階段中的所有持續性參與者，以進行對應。接著，會將在第一和第二階段中收集到的所有值提供給第三階段中的所有持續性參與者，以進行對應，依此類推。

以下清單描述持續性子系統在不同階段的「載入」作業時所執行的工作。持續性參與者會用於第四階段。持續性 I/O 參與者 (同樣參與 I/O 作業的持續性參與者) 也會用於第三階段。

收集加入至與工作流程執行個體相關之擴充集合的所有持續性參與者。
自持續性存放區載入工作流程。
在所有持續性 I/O 參與者上叫用 BeginOnLoad 方法，並等候所有持續性參與者完成。如果持續性的時段屬於異動性質，則異動會在 Transaction.Current 中提供。
根據從持續性存放區所擷取的資料，載入記憶體中的工作流程執行個體。
叫用每個持續性參與者上的 PublishValues。

持續性參與者衍生自 PersistenceParticipant 類別，且可實作 PublishValues 方法。持續性 I/O 參與者衍生自 PersistenceIOParticipant 類別，除了可實作 PublishValues 方法之外，還可實作 BeginOnLoad 方法。

載入工作流程執行個體時，持續性提供者會建立該執行個體的鎖定。這可防止在多節點的案例中，多個主機載入執行個體。如果您試圖載入已鎖定的工作流程執行個體，您將看到像下列的例外狀況：例外狀況 "System.ServiceModel.Persistence.InstanceLockException: 無法完成要求的作業，因為無法取得執行個體 '00000000-0000-0000-0000-000000000000' 的鎖定"。當下列任一情形發生時，就會發生這個錯誤：

在多節點的案例中，執行個體是由另一個主機載入。有幾個不同的方法來解決這些類型的衝突：將處理轉送到擁有鎖定的節點然後重試，或是強制載入，這會導致其他主機無法儲存它們的工作。
在單一節點的案例中且主機毀損。當主機再次啟動時 (處理序回收或建立新的持續性提供者處理站)，新主機嘗試載入執行個體，但此執行個體仍被舊主機鎖定，因為鎖定尚未到期。
在單一節點的案例中，出現問題的執行個體已在某個時間點中止，新的持續性提供者執行個體已建立，其具有不同的主機 ID。

鎖定逾時值預設為 5 分鐘，您可以在呼叫 Load 時指定不同的逾時值。

本節內容

如何：建立自訂持續性參與者

另請參閱

存放區擴充性

持續性參與者

本節內容

另請參閱

意見反應

其他資源