ReplicaMetadata Class

When overridden, provides access to the replica metadata and item metadata in the metadata store. ReplicaMetadata also provides services for delete detection and helpers for implementing synchronization provider methods.

System.Object
  Microsoft.Synchronization.MetadataStorage.ReplicaMetadata

Namespace:  Microsoft.Synchronization.MetadataStorage
Assembly:  Microsoft.Synchronization.MetadataStorage (in Microsoft.Synchronization.MetadataStorage.dll)

'Declaration
Public MustInherit Class ReplicaMetadata
'Usage
Dim instance As ReplicaMetadata

The ReplicaMetadata type exposes the following members.

  NameDescription
Protected methodReplicaMetadataInitializes a new instance of the ReplicaMetadata class that contains the specified ID format schema and replica ID.
Top

  NameDescription
Public propertyCustomReplicaMetadataWhen overridden in a derived class, gets or sets the custom metadata field that is associated with this replica.
Public propertyDeleteDetectorWhen overridden in a derived class, an object that represents the delete detection service.
Public propertyIdFormatsGets the ID format schema for the replica.
Public propertyLastDeletedItemsCleanupTimeWhen overridden in a derived class, gets the time when deleted items were last cleaned up by CleanupDeletedItems.
Public propertyProviderVersionWhen overridden in a derived class, gets or sets the version of the provider that operates on this metadata.
Public propertyReplicaIdGets the ID of the replica that is associated with this metadata.
Top

  NameDescription
Public methodCleanupDeletedItemsWhen overridden in a derived class, removes items that are marked as deleted and that are older than the last successful cleanup time.
Public methodCreateItemMetadataWhen overridden in a derived class, creates a new item metadata object that can be used to add a new item metadata entry to the metadata store.
Public methodEquals (Inherited from Object.)
Public methodExcludeItemFromAllKnowledgeByGlobalIdRemoves knowledge about the specified item from the knowledge.
Protected methodFinalize (Inherited from Object.)
Public methodFindItemMetadataByIdWhen overridden in a derived class, gets item metadata for the item that has the specified global ID.
Public methodFindItemMetadataByIndexedFieldWhen overridden in a derived class, returns a list of item metadata entries that have the specified value for the indexed field.
Public methodFindItemMetadataByIndexedFieldsWhen overridden in a derived class, returns a list of item metadata entries that have the specified values for the set of indexed fields.
Public methodFindItemMetadataByMergeWinnerIdWhen overridden in a derived class, returns a list of item metadata entries that represent merge tombstones that have the specified value for their merge winner ID property.
Public methodFindItemMetadataByUniqueIndexedFieldWhen overridden in a derived class, returns the unique item metadata entry that has the specified value for the indexed field.
Public methodFindItemMetadataByUniqueIndexedFieldsWhen overridden in a derived class, returns the unique item metadata entry that has the specified values for the indexed fields.
Public methodGetAllItemsWhen overridden in a derived class, gets all the items that are contained in the metadata store for this replica.
Public methodGetChangeBatchWhen overridden in a derived class, gets a change batch that contains item metadata for items that are not contained in the specified knowledge from the destination provider.
Public methodGetFilteredChangeBatchWhen overridden in a derived class, gets a change batch that contains item metadata for items that are not contained in the specified knowledge from the destination provider and that are accepted by the specified filter.
Public methodGetFilteredFullEnumerationChangeBatchGets a filtered change batch that contains item metadata for items that have IDs greater than or equal to the specified lower bound, as part of a full enumeration.
Public methodGetFilteredFullEnumerationLocalVersionsWhen overridden in a derived class, gets a filtered change batch that contains the versions of items and change units stored in this replica that correspond to the items and change units referred to in a batch of changes that are sent from some other provider, as part of a full enumeration.
Public methodGetFilteredLocalVersionsWhen overridden in a derived class, gets a filtered batch of changes that contains the versions of items and change units that are stored in this replica. These items and change units correspond to the items and change units referred to in a batch of changes that is sent from some other provider.
Public methodGetForgottenKnowledgeWhen overridden in a derived class, gets the forgotten knowledge for this replica.
Public methodGetFullEnumerationChangeBatchWhen overridden in a derived class, gets a change batch that contains item metadata for items that have IDs equal to or greater than the specified lower bound, as part of a full enumeration.
Public methodGetFullEnumerationLocalVersionsWhen overridden in a derived class, gets a change batch that contains the versions of items and change units stored in this replica that correspond to the items and change units referred to in a batch of changes that are sent from some other provider, as part of a full enumeration.
Public methodGetHashCode (Inherited from Object.)
Public methodGetItemCountWhen overridden in a derived class, gets the total number of items in the metadata store and the number of deleted items in the metadata store.
Public methodGetKnowledgeWhen overridden in a derived class, gets the current knowledge for this replica.
Public methodGetLocalVersionsWhen overridden in a derived class, gets a batch of changes that contains the versions of items and change units that are stored in this replica. These items and change units correspond to the items and change units referred to in a batch of changes that is sent from some other provider.
Public methodGetNextTickCountWhen overridden in a derived class, increments the previously saved tick count for this replica, saves the new value to the store, and returns the new value.
Public methodGetType (Inherited from Object.)
Protected methodMemberwiseClone (Inherited from Object.)
Public methodRemoveItemMetadataWhen overridden in a derived class, removes item metadata from the metadata store.
Public methodSaveItemMetadataWhen overridden in a derived class, saves item metadata property changes to the metadata store.
Public methodSaveReplicaMetadataWhen overridden in a derived class, saves replica metadata property changes to the metadata store.
Public methodSetForgottenKnowledgeWhen overridden in a derived class, sets the forgotten knowledge for this replica.
Public methodSetKnowledgeWhen overridden in a derived class, sets the current knowledge for this replica.
Public methodToString (Inherited from Object.)
Top

ReplicaMetadata provides access to the metadata for the replica as a whole and access to metadata for items in the replica. For more information, see Accessing Replica Metadata.

ReplicaMetadata provides methods that help implement synchronization provider methods, such as GetChangeBatch. For more information, see Interoperating with a Provider.

ReplicaMetadata provides methods that can be used to determine which items were deleted from the replica and, therefore, should be marked as deleted in the metadata store. For more information, see Detecting Deleted Items.

Notes to Inheritors

When you inherit from ReplicaMetadata, you must override all members except IdFormats and ReplicaId.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Show: