Método UpgradePublicTracking
Atualiza metadados de controle em um banco de dados SQL Server Compact SP2 no qual o controle foi habilitado, para uso pelo Microsoft Sync Framework Service Pack 1 (SP1) e versões posteriores do Sync Framework.
Namespace: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (em System.Data.SqlServerCe.dll)
Sintaxe
'Declaração
Public Shared Function UpgradePublicTracking ( _
connectionString As String _
) As Boolean
'Uso
Dim connectionString As String
Dim returnValue As Boolean
returnValue = SqlCeChangeTracking.UpgradePublicTracking(connectionString)
public static bool UpgradePublicTracking(
string connectionString
)
public:
static bool UpgradePublicTracking(
String^ connectionString
)
static member UpgradePublicTracking :
connectionString:string -> bool
public static function UpgradePublicTracking(
connectionString : String
) : boolean
Parâmetros
- connectionString
Tipo: System. . :: . .String
Uma cadeia de conexão para a fonte de dados.
Valor de retorno
Tipo: System. . :: . .Boolean
true se o banco de dados tiver sido atualizado com êxito ou se ele não estiver sendo controlado no momento; caso contrário, false.
Exceções
| Exceção | Condição |
|---|---|
| ArgumentNullException | connectionString is null Nothing nullptr unit uma referência nula (Nothing no Visual Basic) . |
Comentários
A atualização dos metadados de sincronização do Sync Framework 1.0 para o Sync Framework 1.0 SP1 é realizada em duas fases.
A primeira fase ocorre automaticamente quando o SQL Server Compact 3.5 Service Pack 2 (SP2) abre um banco de dados SQL SQL Server Compact 3.5 ou SQL Server Compact 3.5 Service Pack 1 (SP1) que está sendo usado pelo Sync FX 1.0. Quando isso ocorre, em tabelas que estão sendo controladas, as colunas de controle de alterações são atualizadas e a coluna de contexto (__sysTrackingContext) é adicionada.
A primeira vez que o Sync Framework 1.0 SP1 ou uma versão posterior do Sync Framework precisa usar um banco de dados SQL Server Compact 3.5 ou SQL Server Compact 3.5 SP1, o método UpgradePublicTracking deve ser chamado. O método UpgradePublicTracking criará novas tabelas chamadas __SyncArticles e __SyncSubscriptions e moverá os dados das tabelas __sysSyncArticles e __sysSyncSubscriptions para essas novas tabelas.
Dica
As novas tabelas, __SyncArticles e __SyncSubscriptions, são tabelas de usuário, e não tabelas do sistema.
Se um banco de dados contiver as tabelas __sysSyncArticles e __sysSyncSubscriptions significa que ela é compatível com o Sync Framework 1.0 e versões anteriores. Nesse caso, o método UpgradePublicTracking deve ser chamado para atualizar os metadados de controle.