DbSyncProvider.SelectNewTimestampCommand-Eigenschaft

Artikel
11/02/2009

Ruft ein IDbCommand-Objekt mit der Abfrage oder gespeicherten Prozedur ab, die einen neuen Timestampwert aus der Peerdatenbank zurückgibt, oder legt ein solches Objekt fest. Durch den Timestamp wird die obere Grenze für die Gruppe von Änderungen definiert, die während der aktuellen Sitzung synchronisiert werden sollen.

Diese Eigenschaft ist nicht CLS-kompatibel.

Namespace: Microsoft.Synchronization.Data
Assembly: Microsoft.Synchronization.Data (in microsoft.synchronization.data.dll)

Syntax

'Declaration
Public Overridable Property SelectNewTimestampCommand As IDbCommand
'Usage
Dim instance As DbSyncProvider
Dim value As IDbCommand

value = instance.SelectNewTimestampCommand

instance.SelectNewTimestampCommand = value

public virtual IDbCommand SelectNewTimestampCommand { get; set; }

public:
virtual property IDbCommand^ SelectNewTimestampCommand {
    IDbCommand^ get ();
    void set (IDbCommand^ value);
}

/** @property */
public IDbCommand get_SelectNewTimestampCommand ()

/** @property */
public void set_SelectNewTimestampCommand (IDbCommand value)

public function get SelectNewTimestampCommand () : IDbCommand

public function set SelectNewTimestampCommand (value : IDbCommand)

Eigenschaftenwert

Ein IDbCommand-Objekt, das eine Abfrage oder gespeicherte Prozedur enthält.

Hinweise

Die Abfrage oder die gespeicherte Prozedur, die für diesen Befehl angegeben ist, gibt einen timestamp-Wert zurück, mit dem Sätze von Änderungen für die einzelnen Peers ausgewählt und übernommen werden. Während der aktuellen Synchronisierungssitzung wird durch den Befehl ein neuer timestamp-Wert bereitgestellt. Alle Änderungen, die nach dem timestamp-Wert der letzten und vor dem timestamp-Wert der neuen Synchronisierungssitzung durchgeführt wurden, werden synchronisiert. Anschließend wird der neue Wert gespeichert und als Ausgangspunkt für die nächste Sitzung verwendet.

Beispiel

Das folgende Codebeispiel gibt einen Befehl zum Abrufen eines neuen timestamp-Werts von einem Peer an. In diesem Fall gibt MIN_ACTIVE_ROWVERSION einen timestamp-Wert aus einer SQL Server-Datenbank zurück. (MIN_ACTIVE_ROWVERSION wurde in SQL Server 2005 Service Pack 2 eingeführt.) Ein timestamp-Wert wird verwendet, da die Nachverfolgungsspalten in der Peerdatenbank timestamp-Werte enthalten. Eine Darstellung dieses Codes im Kontext eines vollständigen Beispiels finden Sie unter Vorgehensweise: Bereitstellen einer Serverdatenbank für die Synchronisierung für die Zusammenarbeit (Nicht-SQL Server).

SqlCommand selectNewTimestampCommand = new SqlCommand();
string newTimestampVariable = "@" + DbSyncSession.SyncNewTimestamp;
selectNewTimestampCommand.CommandText = "SELECT " + newTimestampVariable + " = min_active_rowversion() - 1";
selectNewTimestampCommand.Parameters.Add(newTimestampVariable, SqlDbType.Timestamp);
selectNewTimestampCommand.Parameters[newTimestampVariable].Direction = ParameterDirection.Output;

sampleProvider.SelectNewTimestampCommand = selectNewTimestampCommand;

Dim newTimestampVariable As String = "@" + DbSyncSession.SyncNewTimestamp

Dim selectNewTimestampCommand As New SqlCommand()

With selectNewTimestampCommand
    .CommandText = "SELECT " + newTimestampVariable + " = min_active_rowversion() - 1"
    .Parameters.Add(newTimestampVariable, SqlDbType.Timestamp)
    .Parameters(newTimestampVariable).Direction = ParameterDirection.Output
End With

sampleProvider.SelectNewTimestampCommand = selectNewTimestampCommand

Siehe auch

Verweis

DbSyncProvider-Klasse
DbSyncProvider-Member
Microsoft.Synchronization.Data-Namespace

Freigeben über