ApplyChanges-Methode (IEnumerable(String), DataSet, SyncAnchor)

Übernimmt Einfügungen, Aktualisierungen und Löschvorgänge für eine Synchronisierungsgruppe für die Clientdatenbank, wenn die Parameter für die 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 ( _
    tableNames As IEnumerable(Of String), _
    dataSet As DataSet, _
    serverAnchor As SyncAnchor _
) As SyncContext
'Usage
Dim instance As SqlCeClientSyncProvider
Dim tableNames As IEnumerable(Of String)
Dim dataSet As DataSet
Dim serverAnchor As SyncAnchor
Dim returnValue As SyncContext

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

public SyncContext ApplyChanges(
    IEnumerable<string> tableNames,
    DataSet dataSet,
    SyncAnchor serverAnchor
)

public:
SyncContext^ ApplyChanges(
    IEnumerable<String^>^ tableNames, 
    DataSet^ dataSet, 
    SyncAnchor^ serverAnchor
)

member ApplyChanges : 
        tableNames:IEnumerable<string> * 
        dataSet:DataSet * 
        serverAnchor:SyncAnchor -> SyncContext 

public function ApplyChanges(
    tableNames : IEnumerable<String>, 
    dataSet : DataSet, 
    serverAnchor : SyncAnchor
) : SyncContext

Parameter

• tableNames
  Typ: System.Collections.Generic. . :: . .IEnumerable< (Of < ( <'String> ) > ) >
  Eine Auflistung von Tabellen in der Clientdatenbank, für die Änderungen übernommen werden sollen.

• dataSet
  Typ: System.Data. . :: . .DataSet
  Ein DataSet-Objekt, das die Datenzeilen enthält, die für die Datenbank übernommen werden sollen.

• serverAnchor
  Typ: Microsoft.Synchronization.Data. . :: . .SyncAnchor
  Ein SyncAnchor-Objekt, das den NewAnchor-Wert für diese Synchronisierungssitzung darstellt.

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 DataRowState 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