Classe ChangeApplicationServices
Rappresenta un oggetto del servizio di applicazione modifiche che può essere utilizzato per eseguire singole azioni di applicazione modifiche.
Spazio dei nomi: Microsoft.Synchronization
Assembly: Microsoft.Synchronization (in microsoft.synchronization.dll)
Sintassi
'Dichiarazione
Public Class ChangeApplicationServices
'Utilizzo
Dim instance As ChangeApplicationServices
public class ChangeApplicationServices
public ref class ChangeApplicationServices
public class ChangeApplicationServices
public class ChangeApplicationServices
Osservazioni
L'oggetto ChangeApplicationServices fa parte del servizio di applicazione modifiche di Sync Framework, utilizzato quando un provider richiede più flessibilità rispetto a quella consentita dall'oggetto di applicazione modifiche standard fornito da Sync Framework. Ad esempio, un provider deve posticipare l'applicazione di determinate modifiche alla fine della sessione di sincronizzazione. L'oggetto di applicazione modifiche standard non consente questa operazione. Il provider può utilizzare il servizio di applicazione modifiche per gestire il rilevamento dei conflitti e il calcolo della conoscenza conservando comunque la possibilità di posticipare le modifiche, se necessario.
Per un provider che non necessita della flessibilità aggiuntiva del servizio di applicazione modifiche, può essere più semplice utilizzare un oggetto di applicazione modifiche standard, ad esempio NotifyingChangeApplier.
In genere, il servizio di applicazione modifiche viene utilizzato da un provider di destinazione per implementare i metodi ProcessChangeBatch e ProcessFullEnumerationChangeBatch. Per utilizzare il servizio di applicazione modifiche, effettuare quanto segue:
Creare e inizializzare un nuovo oggetto ChangeApplicationServices.
Avviare l'elaborazione di un batch di modifiche chiamando BeginChangeApplication oppure avviare l'elaborazione di un batch di modifiche della sincronizzazione del recupero chiamando BeginFullEnumerationChangeApplication. In genere, questo metodo viene chiamato una volta per ogni batch di modifiche da elaborare.
Enumerare le modifiche nel batch di modifiche. Chiamare GetChangeApplicationContext una volta per ogni modifica e utilizzare l'oggetto ChangeApplicationContext restituito per applicare la modifica.
Segnalare la corretta applicazione delle modifiche chiamando ReportItemChangeApplied o ReportChangeUnitChangeApplied. Segnalare l'impossibilità di applicare le modifiche chiamando ReportRecoverableErrorOnItemChange o ReportRecoverableErrorOnChangeUnitChange.
Chiamare GetUpdatedDestinationKnowledge in qualsiasi momento per recuperare la conoscenza di destinazione aggiornata che contiene tutte le modifiche applicate finora.
Terminare l'elaborazione di un batch di modifiche chiamando EndChangeApplication oppure terminare l'elaborazione di un batch di modifiche della sincronizzazione del recupero chiamando EndFullEnumerationChangeApplication. Salvare la conoscenza di destinazione aggiornata e gli oggetti conoscenza dimenticata di destinazione che vengono restituiti da questo metodo.
Ripetere i passaggi da 3 a 7 per ogni batch di modifiche ricevuto dal provider di destinazione.
Gerarchia di ereditarietà
System.Object
Microsoft.Synchronization.ChangeApplicationServices
Thread Safety
Tutti i membri statici pubblici (Shared in Visual Basic) di questo tipo sono thread safe. I membri di istanza non hanno garanzia di essere thread safe.
Vedere anche
Riferimento
Membri ChangeApplicationServices
Spazio dei nomi Microsoft.Synchronization