Énumération RdaTrackOption
Spécifie si la table extraite du périphérique fait l'objet ou non d'un suivi.
Espace de noms : System.Data.SqlServerCe
Assembly : System.Data.SqlServerCe (en System.Data.SqlServerCe.dll)
Syntaxe
'Déclaration
Public Enumeration RdaTrackOption
'Utilisation
Dim instance As RdaTrackOption
public enum RdaTrackOption
public enum class RdaTrackOption
type RdaTrackOption
public enum RdaTrackOption
Membres
| Nom de membre | Description | |
|---|---|---|
| TrackingOff | Indique que SQL Server Compact n'effectue pas le suivi des modifications apportées à la table extraite. Aucune contrainte PRIMARY KEY n'est créée localement. | |
| TrackingOn | Indique que SQL Server Compact effectue le suivi de toutes les modifications apportées à la table extraite. Des contraintes PRIMARY KEY relatives à la valeur spécifiée pour sqlSelectString sont créées sur la table locale. Il s'agit de la valeur par défaut. | |
| TrackingOnWithIndexes | Indique que SQL Server Compact effectue le suivi de toutes les modifications apportées à la table extraite. Des index et des contraintes PRIMARY KEY qui existaient sur la table SQL Server spécifiée dans sqlSelectString sont créés sur la table locale. | |
| TrackingOffWithIndexes | Indique que SQL Server Compact n'effectue pas le suivi des modifications apportées à la table extraite. Des index et des contraintes PRIMARY KEY qui existaient sur la table SQL Server spécifiée dans sqlSelectString sont créés sur la table locale. |
Notes
Cette propriété spécifie si SQL Server Compact effectuera le suivi des modifications apportées à la table extraite. Vous pouvez spécifier TrackingOn ou TrackingOnWithIndexes afin tout d'abord de mettre à jour la table extraite sur le smart device, puis de renvoyer (push) les enregistrements modifiés à la table SQL Server d'origine. Lorsque TrackingOn est spécifié, des contraintes PRIMARY KEY sont créées sur la table extraite. Lorsque TrackingOnWithIndexes est spécifié, des contraintes PRIMARY KEY et des index associés sont créés sur la table extraite.
Notes
Un index est créé uniquement si la colonne ou les colonnes composant l'index font l'objet d'une extraction.
Dans les deux cas, SQL Server Compact effectue le suivi de chaque enregistrement qui est inséré, mis à jour ou supprimé dans la table locale.
Lorsque l'application appelle la méthode Push, SQL Server Compact utilise les informations de suivi des modifications pour localiser les enregistrements insérés, mis à jour et supprimés dans la table locale SQL Server Compact et pour propager ces modifications à SQL Server.
Les restrictions suivantes s'appliquent lorsque RdaTrackOption a la valeur TrackingOn ou TrackingOnWithIndexes :
Une erreur se produit si l'instruction SELECT retourne un jeu d'enregistrements qui ne peut pas être mis à jour.
Une clé primaire doit être définie sur le jeu d'enregistrements pouvant être mis à jour retourné par l'instruction SELECT.
L'instruction SELECT peut référencer une vue ou une procédure stockée, mais cette vue ou procédure stockée doit référencer une seule table et doit pouvoir être mise à jour.
Lorsque TrackingOnWithIndexes est spécifié, les index qui existent sur la table SQL Server et concernent les colonnes spécifiées dans l'argument sqlSelectString de la méthode Pull sont créés par rapport à la table locale SQL Server Compact spécifiée dans l'argument localTableName de la méthode Pull.
La propriété errorTableName spécifie le nom de la table dans laquelle les erreurs de type Push doivent être stockées. Si une erreur se produit lorsque l'application appelle la méthode Push, SQL Server Compact crée la table des erreurs et y insère un enregistrement pour chaque erreur qui se produit. Lorsque la méthode Push prend fin, l'application peut examiner la table des erreurs afin de déterminer si des erreurs se sont produites. errorTableName peut être spécifié seulement quand TrackingOn ou TrackingOnWithIndexes est spécifié. Pour plus d'informations sur le fonctionnement de la table des erreurs dans RDA, consultez « Détection et signalement des conflits RDA » dans la documentation en ligne de SQL Server Compact.