Implementazione di un provider personalizzato semplice
In Sync Framework sono disponibili API che vanno da quelle specifiche del dominio, ad esempio il provider di sincronizzazione file, a quelle principali di durata indefinita in grado di attivare la sincronizzazione per qualsiasi tipo di archivio dati. Le API di provider semplici si trovano al centro di questa gamma. Forniscono agli sviluppatori la potenza e la flessibilità delle API principali, ma con una curva di apprendimento minore e una minore quantità di codice, in particolar modo per le repliche con un supporto per il rilevamento delle modifiche irrilevante o del tutto assente. Le API di provider semplici sono estensibili, ma progettate principalmente per due tipi di repliche:
Repliche che non supportano alcun tipo di rilevamento delle modifiche. Questo tipo di replica utilizza un provider di enumerazione completo che enumera tutti gli elementi dalla replica di origine ogni volta che viene eseguita la sincronizzazione.
Repliche che supportano il rilevamento delle modifiche basato su ancoraggio. Questo tipo di replica utilizza un provider basato su ancoraggio che enumera gli elementi dalla replica di origine cambiata dopo l'impostazione di un ancoraggio specifico, in genere un preciso momento nel tempo.
Per ulteriori informazioni sui provider personalizzati, vedere Nozioni fondamentali sui provider personalizzati, in particolar modo la sezione "Scelta tra un provider semplice e un provider standard".
Interfacce primarie e opzioni importanti
Le interfacce di provider semplici sono disponibili nel codice gestito e nel codice nativo. Il codice gestito si trova nello spazio dei nomi Microsoft.Synchronization.SimpleProviders in Microsoft.Synchronization.SimpleProviders.dll. Per ulteriori informazioni, vedere Microsoft.Synchronization.SimpleProviders. Il codice nativo si trova in providerframework.dll e richiede anchorenumerationprovider.h e fullenumerationprovider.h. Per ulteriori informazioni, vedere Componenti dei provider semplici di Sync Framework.
Le interfacce primarie per i provider semplici sono le seguenti:
| Interfacce gestite | Interfacce non gestite |
|---|---|
|
Le interfacce dei provider sono implementate dallo sviluppatore. I metodi dei provider, ad esempio i metodi gestitiUpdateItem o quelli non gestiti UpdateItem sono chiamati dal runtime di Sync Framework durante ogni sessione di sincronizzazione per selezionare e applicare modifiche. Per ognuno di questi metodi, è necessario scrivere un'implementazione specifica della replica, dell'archivio di elementi e in base alle esigenze dell'applicazione. Ad esempio, il metodo di aggiornamento deve essere in grado di eseguire un aggiornamento nell'archivio dati di destinazione e applicare o rispondere in modo appropriato a qualsiasi logica di business che l'applicazione richiede per gli aggiornamenti. Le interfacce di contesto e callback vengono implementate da Sync Framework e forniscono un modo per accedere al contesto della sessione di sincronizzazione. Oltre alle interfacce primarie, l'API del provider semplice include importanti opzioni nelle aree seguenti:
Gestione dei metadati. Per ulteriori informazioni, vedere Gestione dei metadati per provider semplici.
Gestione dei conflitti. Per ulteriori informazioni, vedere Gestione dei conflitti per i provider semplici.
Filtro dei dati. Per ulteriori informazioni, vedere Filtro di dati per provider semplici.
Per ulteriori informazioni sulle considerazioni di progettazione per la creazione di un provider semplice, vedere Considerazioni relative alla progettazione di provider personalizzati semplici.
Per ulteriori informazioni sulla creazione di un provider semplice gestito, vedere Procedura: creare un provider semplice gestito.
Vedere anche
Riferimento
Microsoft.Synchronization.SimpleProviders
Concetti
Sincronizzazione di archivi dati tramite provider personalizzati
Novità di Sync Framework 2.0
Componenti dei provider semplici di Sync Framework