Sync-Methode

Public Function Sync(
    ByVal syncName As String,
    ByVal opts As String
) As UInt32

public UInt32 Sync(String syncName, String opts)

syncName Der Name eines Synchronisationsprofil, das in der entfernten Datenbank definiert ist, welche die Optionen für die Synchronisation enthält. Wenn syncName NULL ist, wird kein Profil verwendet und der Parameter opts muss alle Optionen für die Synchronisation enthalten.
opts Eine Zeichenfolge, die nach denselben Regeln gebildet wird, die auch bei der Definition einer Optionszeichenfolge für ein Synchronisationsprofil verwendet werden. Dabei handelt es sich um eine Zeichenfolge, die durch Semikolons getrennte Elemente in Form von <Optionsname>=<Optionswert> enthält. Wenn syncName Nicht-NULL ist, werden die von opts festgelegten Optionen zu den Optionen hinzugefügt, die bereits im von syncName angegebenen Synchronisationsprofil enthalten sind. Wenn eine in der Zeichenfolge enthaltene Option im Profil bereits vorhanden ist, ersetzt der Wert aus der Zeichenfolge den bereits im Profil gespeicherten Wert. Wenn syncName NULL ist, muss opts alle Optionen für die Synchronisation festlegen. Siehe CREATE SYNCHRONIZATION PROFILE-Anweisung [MobiLink].

Ein ganzzahliger Wert, der diese Synchronisationsanforderung eindeutig identifiziert und nur gültig ist, bis der Client vom Server getrennt wird. Gibt NULL_SYNCHDL zurück, wenn ein Fehler verhindert, dass die Synchronisationsanforderung erstellt wird. Wenn NULL_SYNCHDL zurückgegeben wird, können Sie die Methode GetErrorInfo aufrufen, um weitere Informationen über den Fehler zu erhalten.

Sie müssen mit dem Server verbunden sein, um diese Methode aufrufen zu können. Mindestens eine der Optionen syncName oder opts muss Nicht-NULL sein.

Der Rückgabewert gibt die Synchronisationsanforderung an und kann verwendet werden, um die Anforderung abzubrechen oder die von der Synchronisation zurückgegeben Ereignisse zu verarbeiten.

Das folgende C#-Beispiel zeigt, wie Fehlercodes nach dem Aufrufen der Sync-Methode angezeigt werden.

// Insert code to initialize the syncronization client.

UInt32 request = syncClient.Sync("syncName", null);
if (request == DbmlsyncClient.NULL_SYNCHDL) {
    string error_code = syncClient.GetErrorInfo().type.ToString();
    MessageBox.Show(error_code, "Sync Error");
}

DbmlsyncClient.GetErrorInfo-Methode [Dbmlsync .NET]

Sync-Methode

Visual Basic-Syntax

C#-Syntax

Parameter

Rückgabe

Bemerkungen

Siehe auch