Propriedade SelectNewAnchorCommand
Obtém ou define um objeto IDbCommand que contém a consulta ou o procedimento armazenado que retorna um novo valor de âncora do banco de dados do servidor. A âncora define o limite superior do conjunto de alterações a ser sincronizado durante a sessão atual.
Namespace: Microsoft.Synchronization.Data.Server
Assembly: Microsoft.Synchronization.Data.Server (em Microsoft.Synchronization.Data.Server.dll)
Sintaxe
'Declaração
Public Property SelectNewAnchorCommand As IDbCommand
Get
Set
'Uso
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)
Valor da propriedade
Tipo: System.Data. . :: . .IDbCommand
Um objeto IDbCommand que contém uma consulta ou um procedimento armazenado.
Comentários
Durante a sincronização atual, o novo comando de âncora fornece um novo valor de âncora. As alterações feitas depois do último valor de âncora recebido e antes do novo valor de âncora recebido são sincronizadas. A nova âncora recebida é armazenada e usada como o último valor de âncora recebido para a próxima sincronização. Para obter mais informações, consulte a seção "Determinando quais alterações de dados devem ser baixadas em um cliente" em Controlando alterações no banco de dados do servidor.
Exemplos
O exemplo de código a seguir especifica um comando para recuperar um novo valor de âncora no servidor. Nesse caso, MIN_ACTIVE_ROWVERSION retorna um valor de carimbo de data/hora de um banco de dados do SQL Server. (MIN_ACTIVE_ROWVERSION foi introduzido no SQL Server 2005 Service Pack 2.) Um valor de carimbo de data/hora é usado porque as colunas de controle no banco de dados do servidor contêm valores de carimbo de data/hora. Se as colunas de controle contiverem valores de data, você poderá usar uma função, como GETUTCDATE(), em vez de MIN_ACTIVE_ROWVERSION. SyncSession contém várias constantes de cadeia de caracteres que podem ser usadas em comandos de sincronização. SyncNewReceivedAnchor é uma dessas constantes. Você também pode usar a literal @sync\_new\_received\_anchor diretamente em suas consultas. Para exibir esse código no contexto de um exemplo completo, consulte Guia de introdução: sincronização entre cliente e servidor.
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