Share via

Microsoft.Synchronization.SimpleProviders 命名空間

  • 發行項

這個命名空間包含用來為 Sync Framework 建立簡單提供者的型別。

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

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

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

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

類別

  類別 描述
Public class AnchorEnumerationContext 傳遞給 AnchorEnumerationSimpleSyncProvider 物件的同步處理工作階段內容。
Public class AnchorEnumerationSimpleSyncProvider 表示使用錨定來追蹤變更之複寫的提供者。
Public class ChangeDetectionCompletedEventArgs 提供 ChangeDetectionCompleted 事件的資料。
Public class ChangeUnitVersionDefinition 表示 Sync Framework 執行階段用來判斷是否應該更新變更單位版本的一組欄位。
Public class ConflictVersionInformation 表示發生衝突之特定項目的遠端提供者已知項目版本的相關資訊。
Public class CustomFieldDefinition 表示可用來識別中繼資料存放區中之項目，或是用來儲存項目或變更單位之版本相關資訊的欄位。
Public class FullEnumerationContext 傳遞給 FullEnumerationSimpleSyncProvider 物件的同步處理工作階段內容。
Public class FullEnumerationSimpleSyncProvider 表示不支援任何變更追蹤類型之複寫的提供者。
Public class IdentityRule 定義用來在複寫中識別項目的方式。
Public class ItemEnumerationContext 表示傳遞給提供者的同步處理工作階段內容。
Public class ItemField 表示當變更套用至目的地時，用來識別項目的方式。
Public class ItemFieldDictionary 表示項目及其相關聯的欄位。
Public class ItemMetadataSchema 表示項目的中繼資料結構描述，包括如何識別項目及其版本資訊，以及變更單位的定義方式。
Public class LocalItemChange 表示對本機複寫中項目所做的變更，由 EnumerateChanges 所傳回。
Public class MetadataStoreInitializedEventArgs 提供 MetadataStoreInitialized 事件的資料。
Public class RecoverableErrorReportingContext 表示在某些呼叫期間傳遞給提供者的同步處理工作階段內容，讓提供者能夠報告在該呼叫內容中所發生的任何可復原錯誤。
Public class SimpleSyncItemConflictingEventArgs 提供 ItemConflicting 事件的資料。
Public class SimpleSyncItemConstraintEventArgs 提供 ItemConstraint 事件的資料。
Public class SimpleSyncProvider 表示用來同步處理複寫的簡單提供者。您通常會擴充 FullEnumerationSimpleSyncProvider 或 AnchorEnumerationSimpleSyncProvider。
Public class SimpleSyncServices 表示針對使用簡單提供者之複寫所設計的一組服務。
Public class UnmanagedSimpleSyncProviderWrapper 表示包裝 Unmanaged 簡單提供者的 Managed 物件。

介面

  介面 描述
Public interface IFilteredSimpleSyncProvider 表示篩選資料的提供者，而篩選可能會導致兩個複寫僅同步處理每個複寫可用的資料子集。
Public interface ISimpleSyncProviderConcurrencyConflictResolver 表示處理並行衝突的自訂衝突解決器，例如在本機複寫更新而在遠端複寫刪除相同的項目。
Public interface ISimpleSyncProviderConstraintConflictResolver 表示處理條件約束衝突的自訂衝突解決器，例如在多個複寫中插入重複的項目。
Public interface ISimpleSyncProviderIdGenerator 提供產生自訂格式之識別碼的方式，而這些識別碼會用來在中繼資料存放區內識別複寫和項目。

列舉型別

  列舉型別 描述
Public enumeration ConcurrencyConflictKind 表示由於變更發生在本機與遠端複寫的相同項目上，因此可能會發生的衝突類型。
Public enumeration LocalItemChangeType 表示可針對本機複寫中之項目進行的變更類型。
Public enumeration SimpleSyncProviderDeleteMode 表示是否要將本機項目刪除傳播至其他複寫的選項。
Public enumeration SimpleSyncProviderFilterOptions 表示可用於篩選同步處理的選項。