共用方式為


實作簡單的自訂提供者

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 簡單提供者元件