RdaTrackOption-Enumeration

Gibt an, ob die zum Gerät gesendete Tabelle verfolgt wird.

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

Syntax

'Declaration
Public Enumeration RdaTrackOption
'Usage
Dim instance As RdaTrackOption
public enum RdaTrackOption
public enum class RdaTrackOption
type RdaTrackOption
public enum RdaTrackOption

Elemente

Elementname Beschreibung
TrackingOff Gibt an, dass SQL Server Compact Änderungen an der abgerufenen Tabelle nicht verfolgt. Es werden keine lokalen PRIMARY KEY-Einschränkungen erstellt.
TrackingOn Gibt an, dass von SQL Server Compact alle Änderungen an der abgerufenen Tabelle verfolgt werden. PRIMARY KEY-Einschränkungen für den in sqlSelectString angegebenen Wert werden in der lokalen Tabelle erstellt. Dies ist die Standardeinstellung.
TrackingOnWithIndexes Gibt an, dass SQL Server Compact alle Änderungen an der abgerufenen Tabelle verfolgt. Indizes und PRIMARY KEY-Einschränkungen, die in der in sqlSelectString angegebenen SQL Server-Tabelle vorhanden waren, werden in der lokalen Tabelle erstellt.
TrackingOffWithIndexes Gibt an, dass SQL Server Compact Änderungen an der abgerufenen Tabelle nicht verfolgt. Indizes und PRIMARY KEY-Einschränkungen, die in der in sqlSelectString angegebenen SQL Server-Tabelle vorhanden waren, werden in der lokalen Tabelle erstellt.

Hinweise

Diese Eigenschaft gibt an, ob SQL Server Compact Änderungen an der abgerufenen Tabelle verfolgt. Durch Angabe von TrackingOn oder TrackingOnWithIndexes kann die gesendete Tabelle zuerst auf dem intelligenten Gerät aktualisiert werden. Anschließend können geänderte Datensätze zurück in die ursprüngliche SQL Server-Tabelle gesendet werden. Wenn TrackingOn angegeben ist, werden für die gesendete Tabelle PRIMARY KEY-Einschränkungen erstellt. Wenn TrackingOnWithIndexes angegeben ist, werden für die gesendete Tabelle PRIMARY KEY-Einschränkungen und entsprechende Indizes erstellt.

Hinweis

Ein Index wird nur erstellt, wenn die Spalten gesendet werden, aus denen der Index besteht.

In beiden Fällen verfolgt SQL Server Compact alle Datensätze, die in die lokale Tabelle eingefügt, dort aktualisiert oder gelöscht werden.

Wenn eine Anwendung die Push-Methode aufruft, verwendet SQL Server Compact die Informationen zur Änderungsverfolgung, um die eingefügten, aktualisierten und gelöschten Datensätze in der lokalen SQL Server Compact-Tabelle zu suchen und diese Änderungen an SQL Server zurückzugeben.

Wenn RdaTrackOption auf TrackingOn oder TrackingOnWithIndexes festgelegt ist, gelten die folgenden Einschränkungen:

  • Wenn die SELECT-Anweisung ein Recordset zurückgibt, das nicht aktualisiert werden kann, tritt ein Fehler auf.

  • Für das von der SELECT-Anweisung zurückgegebene aktualisierbare Recordset muss ein Primärschlüssel definiert sein.

  • Die SELECT-Anweisung kann auf eine Sicht oder eine gespeicherte Prozedur verweisen, doch darf die Sicht bzw. die gespeicherte Prozedur nur auf eine einzige Tabelle verweisen und muss aktualisiert werden können.

  • Wenn TrackingOnWithIndexes angegeben ist, werden Indizes, die in der SQL Server-Tabelle vorhanden und für die im sqlSelectString-Argument der Pull-Methode angegebenen Spalten relevant sind, für die lokale Tabelle von SQL Server Compact so erstellt, wie im localTableName -Argument von Pull angegeben.

Die errorTableName-Eigenschaft gibt den Namen der Tabelle an, in der Fehler bei Push-Vorgängen gespeichert werden sollen. Wenn beim Aufruf der Push-Methode durch die Anwendung ein Fehler auftritt, erstellt SQL Server Compact die Fehlertabelle und fügt der Tabelle für jeden aufgetretenen Fehler einen Datensatz hinzu. Nach Abschluss der Push-Methode kann die Anwendung die Fehlertabelle überprüfen, um zu bestimmen, ob Fehler aufgetreten sind. errorTableName kann nur angegeben werden, wenn TrackingOn oder TrackingOnWithIndexes angegeben ist. Weitere Informationen zur Funktionsweise der Fehlertabelle in RDA finden Sie in der Onlinedokumentation zu SQL Server Compact unter "Konflikterkennung und -berichterstellung für RDA".

Siehe auch

Verweis

System.Data.SqlServerCe-Namespace

Pull