UpgradePublicTracking-Methode
Aktualisiert Nachverfolgungsmetadaten in einer SQL Server Compact SP2-Datenbank, für die die Nachverfolgung aktiviert wurde, damit sie von Microsoft Sync Framework Service Pack 1 (SP1) und höheren Versionen von Sync Framework verwendet werden kann.
Namespace: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (in System.Data.SqlServerCe.dll)
Syntax
'Declaration
Public Shared Function UpgradePublicTracking ( _
connectionString As String _
) As Boolean
'Usage
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
Parameter
- connectionString
Typ: System. . :: . .String
Eine Verbindungszeichenfolge zur Datenquelle.
Rückgabewert
Typ: System. . :: . .Boolean
true , wenn die Datenbank erfolgreich aktualisiert wurde oder wenn die Datenbank derzeit nicht nachverfolgt wird; andernfalls false.
Ausnahmen
Ausnahme | Bedingung |
---|---|
ArgumentNullException | connectionString ist NULL. |
Hinweise
Das Upgrade der Synchronisierungsmetadaten von Sync Framework 1.0 auf Sync Framework 1.0 SP1 erfolgt in zwei Phasen.
Die erste Phase erfolgt automatisch, wenn SQL Server Compact 3.5 Service Pack 2 (SP2) eine SQL Server Compact 3.5- oder eine SQL Server Compact 3.5 Service Pack 1 (SP1)-Datenbank öffnet, die von Sync FX 1.0 verwendet wird. In diesem Fall werden für nachverfolgte Tabellen die Änderungsnachverfolgungsspalten aktualisiert und die Kontextspalte (__sysTrackingContext) hinzugefügt.
Wenn Sync Framework 1.0 SP1 oder eine höhere Version von Sync Framework erstmalig eine SQL Server Compact 3.5- oder SQL Server Compact 3.5 SP1-Datenbank verwenden muss, ist es erforderlich, die UpgradePublicTracking-Methode aufzurufen. Die UpgradePublicTracking-Methode erstellt neue Tabellen mit den Namen __SyncArticles und __SyncSubscriptions und verschiebt die Daten aus der __sysSyncArticles-Tabelle und der __sysSyncSubscriptions-Tabelle in diese neuen Tabellen.
Hinweis
Die neuen Tabellen __SyncArticles und __SyncSubscriptions sind Benutzertabellen und keine Systemtabellen.
Wenn eine Datenbank die __sysSyncArticles-Tabelle und die __sysSyncSubscriptions-Tabelle enthält, ist sie mit Sync Framework 1.0 und früheren Versionen kompatibel. In diesem Fall muss die UpgradePublicTracking-Methode aufgerufen werden, um die Nachverfolgungsmetadaten zu aktualisieren.