Share via

實作簡單的自訂提供者

  • 發行項

Sync Framework 提供的 API 範圍從網域特有的 API (例如檔案同步處理提供者)，一直到可以針對任何資料存放區類型啟用同步處理的開放式核心 API。簡單提供者 API 在這個範圍的中間。這類 API 為開發人員提供了核心 API 的許多能力和彈性，但是學習曲線和程式碼都會比較少，尤其對於那些具有很少或完全沒有變更追蹤支援的複寫而言。簡單提供者 API 可以延伸，但它主要是針對兩種類型的複寫而設計：

  • 不支援任何變更追蹤類型的複寫。這種類型的複寫會使用「完整列舉提供者」(Full Enumeration Provider)，在每次發生同步處理時列舉來源複寫中的所有項目。

  • 支援以錨定為基礎之變更追蹤的複寫。這種類型的複寫會使用「以錨定為基礎的提供者」(Anchor-based Provider)，列舉來源複寫中在設定特定錨定之後變更的項目 (通常是某個時間點)。

如需自訂提供者的詳細資訊，請參閱自訂提供者的基本原則，尤其是＜在簡單提供者與標準提供者之間做選擇＞一節。

主要介面和重要選項

Managed 程式碼和機器碼都有提供簡單提供者介面。Managed 程式碼位於 Microsoft.Synchronization.SimpleProviders.dll 中的 Microsoft.Synchronization.SimpleProviders 命名空間。如需詳細資訊，請參閱 Microsoft.Synchronization.SimpleProviders。機器碼位於 providerframework.dll，而且需要 anchorenumerationprovider.h 和 fullenumerationprovider.h。如需詳細資訊，請參閱Sync Framework 簡單提供者元件。

簡單提供者的主要介面如下所示：

Managed 介面 Unmanaged 介面

FullEnumerationSimpleSyncProvider

IFullEnumerationSyncProvider 介面

AnchorEnumerationSimpleSyncProvider

IAnchorSyncProvider 介面

FullEnumerationContext

IFullEnumerationCallback 介面

AnchorEnumerationContext

IAnchorChangeDetectionCallback 介面

ItemEnumerationContext

 

提供者介面是由開發人員所實作。提供者方法 (例如 Managed UpdateItem 或 Unmanaged UpdateItem) 是由 Sync Framework 執行階段在每一個同步處理工作階段期間所呼叫，以選取及套用變更。對於每一個方法而言，您都必須撰寫複寫、項目存放區和應用程式需求所特有的實作。例如，更新方法必須能夠在目的地資料存放區中執行更新，並適當地強制或回應應用程式對於更新所需的任何商務邏輯。內容和回呼介面是由 Sync Framework 實作，並提供方法來存取同步處理工作階段的內容。除了主要介面以外，簡單提供者 API 也包含了以下方面的重要選項：

如需建立簡單提供者時設計考量的詳細資訊，請參閱簡單自訂提供者設計的考量。

如需建立 Managed 簡單提供者的詳細資訊，請參閱 HOW TO：建立 Managed 簡單提供者。

請參閱

參考

Microsoft.Synchronization.SimpleProviders

概念

使用自訂提供者同步處理資料存放區
Sync Framework 2.0 的新功能
Sync Framework 簡單提供者元件