ApplyChanges-Methode (String, DataSet, SyncAnchor)

Übernimmt Einfügungen, Aktualisierungen und Löschvorgänge für eine Synchronisierungsgruppe für die Clientdatenbank, wenn die Parameter für den Tabellennamen, das Dataset und den Serveranker angegeben werden.

Namespace:  Microsoft.Synchronization.Data.SqlServerCe
Assembly:  Microsoft.Synchronization.Data.SqlServerCe (in Microsoft.Synchronization.Data.SqlServerCe.dll)

Syntax

'Declaration
Public Function ApplyChanges ( _
    tableName As String, _
    dataSet As DataSet, _
    serverAnchor As SyncAnchor _
) As SyncContext
'Usage
Dim instance As SqlCeClientSyncProvider
Dim tableName As String
Dim dataSet As DataSet
Dim serverAnchor As SyncAnchor
Dim returnValue As SyncContext

returnValue = instance.ApplyChanges(tableName, _
    dataSet, serverAnchor)

public SyncContext ApplyChanges(
    string tableName,
    DataSet dataSet,
    SyncAnchor serverAnchor
)

public:
SyncContext^ ApplyChanges(
    String^ tableName, 
    DataSet^ dataSet, 
    SyncAnchor^ serverAnchor
)

member ApplyChanges : 
        tableName:string * 
        dataSet:DataSet * 
        serverAnchor:SyncAnchor -> SyncContext 

public function ApplyChanges(
    tableName : String, 
    dataSet : DataSet, 
    serverAnchor : SyncAnchor
) : SyncContext

Parameter

  • tableName
    Typ: System. . :: . .String
    Eine Tabelle in der Clientdatenbank, für die Änderungen übernommen werden sollen.

Rückgabewert

Typ: Microsoft.Synchronization.Data. . :: . .SyncContext
Ein SyncContext-Objekt, das Datenänderungen, Ankerwerte und andere Metadaten für eine Synchronisierungssitzung enthält.

Ausnahmen

Ausnahme Bedingung
ArgumentNullException

tableName oder dataSet ist NULL.
DataSyncException

Eine andere Transaktion wird ausgeführt.

Hinweise

Diese Methode setzt voraus, dass die Tabelle in der Clientdatenbank enthalten ist; anderenfalls löst die Methode eine Ausnahme aus. Wenn die Tabelle vorhanden ist, jedoch keine Nachverfolgung aktiviert wurde, wird die bidirektionale Nachverfolgung aktiviert. Zeilen werden mit einem DataRowState-Wert gekennzeichnet, um zwischen Einfügungen, Aktualisierungen und Löschvorgängen zu unterscheiden.

Die Übernahme von Änderungen erfolgt in der folgenden Reihenfolge: Löschvorgänge, Einfügungen, Aktualisierungen. Die Reihenfolge, in der Änderungen für die einzelnen Tabellen in einer Synchronisierungsgruppe übernommen werden, hängt von der Reihenfolge ab, in der der Gruppe Tabellen hinzugefügt werden. Löschvorgänge werden in umgekehrter Reihenfolge der Hinzufügung der Tabellen durchgeführt. Einfügungen und Aktualisierungen werden in der Reihenfolge durchgeführt, in der die Tabellen hinzugefügt werden.

Wenn Sie z. B. zunächst die Tabelle SalesOrderHeader und anschließend die Tabelle SalesOrderDetail zur gleichen Synchronisierungsgruppe hinzufügen, gilt für die Synchronisierung die folgende Verarbeitungsreihenfolge:

  1. Löschvorgänge werden auf SalesOrderDetail und anschließend auf SalesOrderHeader angewendet.

  2. Einfügungsvorgänge werden auf SalesOrderHeader und anschließend auf SalesOrderDetail angewendet.

  3. Aktualisierungsvorgänge werden auf SalesOrderHeader und anschließend auf SalesOrderDetail angewendet.

Siehe auch

Verweis

SqlCeClientSyncProvider Klasse

SqlCeClientSyncProvider-Member

ApplyChanges-Überladung

Microsoft.Synchronization.Data.SqlServerCe-Namespace

  • Last updated on