SelectNewAnchorCommand propriété
Obtient ou définit un objet IDbCommand qui contient la requête ou la procédure stockée qui retourne une nouvelle valeur d'ancre de la base de données serveur. L'ancre définit la limite supérieure de l'ensemble de modifications à synchroniser au cours de la session active.
Espace de noms : Microsoft.Synchronization.Data.Server
Assembly : Microsoft.Synchronization.Data.Server (dans Microsoft.Synchronization.Data.Server.dll)
Syntaxe
'Déclaration
Public Property SelectNewAnchorCommand As IDbCommand
Get
Set
'Utilisation
Dim instance As DbServerSyncProvider
Dim value As IDbCommand
value = instance.SelectNewAnchorCommand
instance.SelectNewAnchorCommand = value
public IDbCommand SelectNewAnchorCommand { get; set; }
public:
property IDbCommand^ SelectNewAnchorCommand {
IDbCommand^ get ();
void set (IDbCommand^ value);
}
member SelectNewAnchorCommand : IDbCommand with get, set
function get SelectNewAnchorCommand () : IDbCommand
function set SelectNewAnchorCommand (value : IDbCommand)
Valeur de la propriété
Type : System.Data. . :: . .IDbCommand
Objet IDbCommand qui contient une requête ou une procédure stockée.
Notes
Au cours de la synchronisation active, la nouvelle commande d'ancre fournit une nouvelle valeur d'ancre. Les modifications apportées après la réception de la dernière valeur d'ancre et avant la réception de la nouvelle valeur d'ancre sont synchronisées. La nouvelle ancre reçue est alors stockée et utilisée en tant que dernière valeur d'ancre reçue pour la synchronisation suivante. Pour plus d'informations, consultez la section « Identification des modifications de données à télécharger sur un client » dans Suivi des modifications dans la base de données serveur.
Exemples
L'exemple de code suivant spécifie une commande permettant de récupérer une nouvelle valeur d'ancre à partir du serveur. Dans ce cas, MIN_ACTIVE_ROWVERSION retourne une valeur d'horodatage à partir d'une base de données SQL Server. (MIN_ACTIVE_ROWVERSION a été introduit dans SQL Server 2005 Service Pack 2.) Une valeur d'horodatage est utilisée car les colonnes de suivi dans la base de données serveur contiennent des valeurs d'horodatage. Si les colonnes de suivi contenaient des valeurs de date, vous pourriez utiliser une fonction telle que GETUTCDATE() au lieu de MIN_ACTIVE_ROWVERSION. SyncSession contient plusieurs constantes de chaîne utilisables dans les commandes de synchronisation. SyncNewReceivedAnchor est l'une de ces constantes. Vous pouvez également utiliser le littéral @sync\_new\_received\_anchor directement dans vos requêtes. Pour afficher ce code dans le contexte d'un exemple complet, consultez Mise en route : synchronisation client et serveur.
SqlCommand selectNewAnchorCommand = new SqlCommand();
string newAnchorVariable = "@" + SyncSession.SyncNewReceivedAnchor;
selectNewAnchorCommand.CommandText = "SELECT " + newAnchorVariable + " = min_active_rowversion() - 1";
selectNewAnchorCommand.Parameters.Add(newAnchorVariable, SqlDbType.Timestamp);
selectNewAnchorCommand.Parameters[newAnchorVariable].Direction = ParameterDirection.Output;
selectNewAnchorCommand.Connection = serverConn;
this.SelectNewAnchorCommand = selectNewAnchorCommand;
Dim selectNewAnchorCommand As New SqlCommand()
Dim newAnchorVariable As String = "@" + SyncSession.SyncNewReceivedAnchor
selectNewAnchorCommand.CommandText = "SELECT " + newAnchorVariable + " = min_active_rowversion() - 1"
selectNewAnchorCommand.Parameters.Add(newAnchorVariable, SqlDbType.Timestamp)
selectNewAnchorCommand.Parameters(newAnchorVariable).Direction = ParameterDirection.Output
selectNewAnchorCommand.Connection = serverConn
Me.SelectNewAnchorCommand = selectNewAnchorCommand