Share via


Enumeração RdaTrackOption

Especifica se a tabela que está sendo puxada no dispositivo é controlada.

Namespace:  System.Data.SqlServerCe
Assembly:  System.Data.SqlServerCe (em System.Data.SqlServerCe.dll)

Sintaxe

'Declaração
Public Enumeration RdaTrackOption
'Uso
Dim instance As RdaTrackOption
public enum RdaTrackOption
public enum class RdaTrackOption
type RdaTrackOption
public enum RdaTrackOption

Membros

Nome do membro Descrição
TrackingOff Indica que o SQL Server Compact não controla as alterações da tabela puxada. Nenhuma restrição de PRIMARY KEY é criada localmente.
TrackingOn Indica que o SQL Server Compact controla todas as alterações da tabela puxada. As restrições PRIMARY KEY relacionadas ao valor especificado para sqlSelectString são criadas na tabela local. Essa é a configuração padrão.
TrackingOnWithIndexes Indica que o SQL Server Compact controla todas as alterações da tabela puxada. Os índices e as restrições PRIMARY KEY que existiam na tabela do SQL Server especificada em sqlSelectString são criados na tabela local.
TrackingOffWithIndexes Indica que o SQL Server Compact não controla as alterações da tabela puxada. Os índices e as restrições PRIMARY KEY que existiam na tabela do SQL Server especificada em sqlSelectString são criados na tabela local.

Comentários

Esta propriedade especifica se o SQL Server Compact controlará as alterações da tabela puxada. Você pode especificar TrackingOn ou TrackingOnWithIndexes para atualizar a tabela puxada no dispositivo inteligente primeiro e, em seguida, enviar os registros alterados por push de volta à tabela original do SQL Server. Quando TrackingOn é especificado, são criadas restrições de PRIMARY KEY na tabela puxada. Quando TrackingOnWithIndexes é especificado, são criadas restrições de PRIMARY KEY e os índices relacionados na tabela puxada.

Dica

Será criado um índice somente se a coluna (ou colunas) que o formam forem puxadas.

Nos dois casos, o SQL Server Compact controlará todos os registros inseridos, atualizados ou excluídos da tabela local.

Quando o aplicativo chama o método Push, o SQL Server Compact usa as informações do controle de alterações para localizar os registros inseridos, atualizados e excluídos na tabela local do SQL Server Compact e propaga essas alterações de volta ao SQL Server.

As restrições a seguir se aplicam quando RdaTrackOption é definido como TrackingOn ou TrackingOnWithIndexes:

  • Ocorrerá um erro se a instrução SELECT retornar um conjunto de registros não atualizáveis.

  • É necessário definir uma chave primária no conjunto de registros atualizável retornado pela instrução SELECT.

  • A instrução SELECT pode referenciar um modo de exibição ou um procedimento armazenado, mas o modo de exibição ou o procedimento armazenado deve referenciar apenas uma tabela e deve ser atualizável.

  • Quando TrackingOnWithIndexes é especificado, os índices que existem na tabela do SQL Server e que são relevantes para as colunas especificadas no argumento sqlSelectString do método Pull são criados na tabela local do SQL Server Compact, conforme especificado no argumento localTableName de Pull.

A propriedade errorTableName especifica o nome da tabela na qual os erros de Push devem ser armazenados. Se um erro for gerado quando o aplicativo chama o método Push, o SQL Server Compact criará a tabela de erros e inserirá um registro na tabela para cada erro que ocorrer. Quando o método Push for concluído, o aplicativo poderá examinar a tabela de erros para determinar se ocorreram erros. errorTableName poderá ser especificado somente quando TrackingOn ou TrackingOnWithIndexes for especificado. Para obter mais informações sobre como funciona a tabela de erros no RDA, consulte "Detecção e resolução de conflitos RDA" nos Manuais Online do SQL Server Compact.

Consulte também

Referência

Namespace System.Data.SqlServerCe

Pull