Compartir a través de

Propiedad TableDef.ReplicaFilter (DAO)

Se aplica a: Access 2013, Office 2013

Establece o devuelve un valor en un objeto TableDef dentro de una réplica parcial que indica el subconjunto de registros que se replica a esa tabla desde una réplica completa. (Sólo para áreas de trabajo de Microsoft Access).

Sintaxis

expresión . ReplicaFilter

expression Variable que representa un objeto TableDef.

Comentarios

La configuración o el valor devuelto es un String o Boolean que indica el subconjunto de registros que se replica, como se especifica en la siguiente tabla:

Valor

Descripción

Una cadena

Criterios que un registro de la réplica parcial debe satisfacer para replicarse desde una réplica completa.

True

Replica todos los registros.

False

(Valor predeterminado) no replica ningún registro.

Esta propiedad es similar a una cláusula SQL WHERE (sin la palabra WHERE), pero no se pueden especificar subconsultas, funciones de agregado (como Count) o funciones definidas por el usuarios dentro del criterio.

Solo se pueden sincronizar datos entre una réplica completa y una réplica parcial. No se pueden sincronizar datos entre dos réplicas parciales. Además, con la réplica parcial se pueden establecer restricciones que indiquen los registros que se replican, pero no se pueden indicar los campos replicados.

Generalmente, se restablece un filtro de réplica cuando se desea replicar un conjunto de registros distinto. Por ejemplo, cuando un representante de ventas se hace cargo temporalmente de la región de otro representante de ventas, la aplicación de la base de datos puede replicar temporalmente datos de ambas regiones y, a continuación, volver al filtro anterior. En este caso, la aplicación restablece la propiedad ReplicaFilter y después vuelve a llenar la réplica parcial.

Si su aplicación cambia los filtros de réplica, debería seguir los pasos que se indican a continuación:

  1. Utilice el método Synchronize para sincronizar su réplica completa con la réplica parcial en la que se han cambiado los filtros.

  2. Utilice la propiedad ReplicaFilter para realizar los cambios que desee en el filtro de réplica.

  3. Utilice el método PopulatePartial para quitar todos los registros de la réplica parcial y transferir todos los registros desde la réplica completa que cumplen los nuevos criterios de filtro de réplica.

Para quitar un filtro, establezca la propiedad ReplicaFilter en False. Si quita todos los filtros y llama al método PopulatePartial, no aparecerá ningún registro en ninguna tabla replicada de la réplica parcial.

Nota:

Si se cambia un filtro de réplica y se abre el método Synchronize sin abrir primero PopulatePartial, se produce un error capturable.

Ejemplo

En el siguiente ejemplo se utiliza la propiedad ReplicaFilter para replicar sólo los registros de los clientes de la región de California.

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
  • Last updated on