Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
S’applique à : Access 2013, Office 2013
Définit ou renvoie une valeur sur un objet TableDef au sein d'un réplica partiel qui indique le sous-ensemble d'enregistrements répliqué vers cette table à partir d'un réplica complet. (Espaces de travail Microsoft Access uniquement).
Syntaxe
expression . ReplicaFilter
expression Variable représentant un objet TableDef.
Remarques
Le paramètre ou la valeur de retour est un type String ou Boolean spécifiant le sous-ensemble d'enregistrements qui est répliqué, comme indiqué dans le tableau suivant :
Valeur |
Description |
|---|---|
Chaîne de caractères |
Critère auquel un enregistrement de la table du réplica partiel doit satisfaire afin d'être répliqué à partir du réplica complet. |
True |
Réplique tous les enregistrements |
False |
(Par défaut) Ne réplique aucun enregistrement. |
Cette propriété est similaire à une clause SQL WHERE (sans le mot WHERE) à cette différence que vous ne pouvez pas spécifier de sous-requêtes, de fonctions d'agrégation (p.ex. Count) ni de fonctions définies par l'utilisateur dans les critères.
La synchronisation des données n'est possible qu'entre un réplica complet et un réplica partiel. Vous ne pouvez pas synchroniser des données entre deux réplicas partiels. En outre, avec la réplication partielle, vous pouvez définir des restrictions quant aux enregistrements à répliquer mais vous ne pouvez pas indiquer quels champs sont répliqués.
En général vous redéfinissez un filtre de réplica lorsque vous souhaitez répliquer un autre jeu d'enregistrements. Par exemple, lorsqu'un représentant commercial reprend provisoirement le territoire de vente d'un autre représentant, l'application de base de données peut répliquer temporairement les données pour les deux régions puis revenir au filtre précédent. Dans ce scénario, l'application redéfinit la propriété ReplicaFilter puis remplit à nouveau le réplica partiel.
Si votre application modifie les filtres de réplica, procédez comme suit :
Appelez la méthode Synchronize pour synchroniser votre réplica complet avec le réplica partiel dans lequel les filtres sont modifiés.
Utilisez la propriété ReplicaFilter pour apporter les modifications requises au filtre de réplica.
Appelez la méthode PopulatePartial pour supprimer tous les enregistrement du réplica partiel et transférer tous les enregistrements du réplica complet correspondant aux nouveaux critères de filtre de réplica.
Pour supprimer un filtre, affectez à la propriété ReplicaFilter la valeur False. Si vous supprimez tous les filtres et que vous appelez la méthode PopulatePartial, aucun enregistrement n'apparaîtra dans les tables répliquées du réplica partiel.
Remarque
[!REMARQUE] Si un filtre de réplica a été modifié et que la méthode Synchronize est exécutée sans avoir préalablement appelé la méthode PopulatePartial, une erreur piégeable se produit.
Exemple
L'exemple suivant utilise la propriété ReplicaFilter pour répliquer uniquement les enregistrements clients de Californie.
Sub ReplicaFilterX()
' This example assumes the current open database
' is the replica.
Dim tdfCustomers As TableDef
Dim strFilter As String
Dim dbsTemp As Database
Set dbsTemp = OpenDatabase("Northwind.mdb")
Set tdfCustomers = dbsTemp.TableDefs("Customers")
' Synchronize with full replica
' before setting replica filter.
dbsTemp.Synchronize "C:\SALES\FY96.MDB"
strFilter = "Region = 'CA'"
tdfCustomers.ReplicaFilter = strFilter
dbsTemp.PopulatePartial "C:\SALES\FY96.MDB"
' Now remove the replica filter (for example purposes
' only).
tdfCustomers.ReplicaFilter = False
' Repopulate the database.
dbsTemp.PopulatePartial "C:\SALES\DATA96.MDB"
End Sub