Database.PopulatePartial-Methode (DAO)
Gilt für: Access 2013, Office 2013
Synchronisiert alle Änderungen an einem Teilreplikat mit dem vollständigen Replikat, löscht alle Datensätze im Teilreplikat und füllt dann das Teilreplikat basierend auf den aktuellen Replikatfiltern erneut auf. (Nur Datenbanken des Microsoft Access-Datenbankmoduls.)
Syntax
Ausdruck . PopulatePartial(DbPathName)
Ausdruck Eine Variable, die ein Database -Objekt darstellt.
Parameter
Name |
Erforderlich/optional |
Datentyp |
Beschreibung |
|---|---|---|---|
DbPathName |
Erforderlich |
String |
Der Pfad und Name des vollständigen Replikats, aus dem Datensätze aufgefüllt werden sollen. |
Hinweise
When you synchronize a partial replica with a full replica, it is possible to create "orphaned" records in the partial replica. Angenommen, Sie verfügen über eine Customers-Tabelle, deren ReplicaFilter auf "Region = 'CA'" festgelegt ist. If a user changes a customer's region from CA to NY in the partial replica, and then a synchronization occurs via the Synchronize method, the change is propagated to the full replica but the record containing NY in the partial replica is orphaned because it now doesn't meet the replica filter criteria.
Mit der PopulatePartial-Methode lässt sich das Problem der verwaisten Datensätze vermeiden. Die PopulatePartial-Methode ähnelt der Synchronize-Methode, synchronisiert allerdings alle Änderungen mit dem vollständigen Repliktat, entfernt alle Datensätze im Teilreplikat, und füllt anschließend das Teilreplikat auf Basis der aktuellen Replikatfilter erneut auf. Auch wenn sich die Replikatfilter nicht geändert haben, werden mit PopulatePartial immer sämtliche Datensätze im Teilreplikat entfernt, und dann wird es auf Basis der aktuellen Filter neu aufgefüllt.
Die PopulatePartial-Methode sollten Sie immer dann verwenden, wenn Sie ein Teilreplikat erstellen und wenn Sie die Replikatfilter ändern. Werden Replikatfilter durch die Anwendung geändert, sollten Sie wie folgt vorgehen:
Synchronisieren Sie das vollständige Repliktat mit dem Teilreplikat, in dem die Filter geändert werden.
Verwenden Sie die Eigenschaften ReplicaFilter und PartialReplica, um die gewünschten Änderungen an den Replikatfiltern vorzunehmen.
Rufen Sie die PopulatePartial-Methode auf, um alle Datensätze aus dem Teilreplikat zu entfernen und alle Datensätze aus dem vollständigen Repliktat zu übertragen, die den neuen Replikatfilterkriterien entsprechen.
Wenn ein Replikatfilter geändert wurde und die Synchronize-Methode ohne vorherigen Aufruf von PopulatePartial aufgerufen wird, tritt ein abfangbarer Fehler auf.
Die PopulatePartial-Methode kann nur für ein Teilreplikat aufgerufen werden, das exklusiv geöffnet ist. Darüber hinaus kann die PopulatePartial-Methode nicht über Code aufgerufen werden, der innerhalb des Teilreplikats ausgeführt wird. Öffnen Sie das Teilreplikat stattdessen exklusiv aus dem vollständigen Repliktat oder einer anderen Datenbank, und rufen Sie dann PopulatePartial auf.
Hinweis
[!HINWEIS] Obwohl PopulatePartial vor dem Löschen und erneuten Auffüllen des Teilreplikats eine einseitige Synchronisierung durchführt, ist es empfehlenswert, Synchronize vor PopulatePartial aufzurufen. Wenn das Aufrufen von Synchronize fehlschlägt, tritt ein abfangbarer Fehler auf. Anhand dieses Fehlers können Sie entscheiden, ob Sie mit der PopulatePartial-Methode fortfahren möchten (bei der alle Datensätze im Teilreplikat entfernt werden). Wird PopulatePartial selbst aufgerufen und tritt während der Synchronisierung der Datensätze ein Fehler auf, werden die Datensätze im Teilreplikat auf jeden Fall gelöscht, auch wenn dies nicht Ihre Absicht war.
Beispiel
Im folgenden Beispiel wird die PopulatePartial-Methode nach dem Ändern eines Replikatfilters verwendet.
Sub PopulatePartialX()
Dim tdfCustomers As TableDef
Dim strFilter As String
Dim dbsTemp As Database
' Open the partial replica in exclusive mode.
Set dbsTemp = OpenDatabase("F:\SALES\FY96CA.MDB", True)
With dbsTemp
Set tdfCustomers = .TableDefs("Customers")
' Synchronize with full replica
' before setting replica filter.
.Synchronize "C:\SALES\FY96.MDB"
strFilter = "Region = 'CA'"
tdfCustomers.ReplicaFilter = strFilter
' Populate records from the full replica.
.PopulatePartial "C:\SALES\FY96.MDB"
.Close
End With
End Sub