SyncGroup Propiedad
Obtiene o establece el objeto SyncGroup que representa el grupo al que pertenece esta clase SyncTable.
Espacio de nombres: Microsoft.Synchronization.Data
Ensamblado: Microsoft.Synchronization.Data (en Microsoft.Synchronization.Data.dll)
Sintaxis
'Declaración
Public Property SyncGroup As SyncGroup
Get
Set
'Uso
Dim instance As SyncTable
Dim value As SyncGroup
value = instance.SyncGroup
instance.SyncGroup = value
public SyncGroup SyncGroup { get; set; }
public:
property SyncGroup^ SyncGroup {
SyncGroup^ get ();
void set (SyncGroup^ value);
}
member SyncGroup : SyncGroup with get, set
function get SyncGroup () : SyncGroup
function set SyncGroup (value : SyncGroup)
Valor de la propiedad
Tipo: Microsoft.Synchronization.Data. . :: . .SyncGroup
Objeto SyncGroup que representa el grupo al que pertenece esta clase SyncTable.
Excepciones
| Excepción | Condición |
|---|---|
| ArgumentException | value está vacío o es un valor null Nothing nullptr unit es una referencia NULL (Nothing en Visual Basic). . |
Notas
Una vez definida una tabla de sincronización, es posible agregarla a un grupo de sincronización. Un grupo de sincronización proporciona un mecanismo para garantizar la coherencia en la aplicación de los cambios para un conjunto de tablas. En caso de incluir tablas en un grupo de sincronización, los cambios sobre esas tablas se transfieren como una unidad y se aplican en una única transacción. Si se produce un error en algún cambio incluido en el grupo, los cambios de todo el grupo se reintentarán en la siguiente sincronización.
Ejemplos
El ejemplo de código siguiente procede de una clase derivada de SyncAgent. El código crea dos grupos de sincronización y tres tablas de sincronización. La tabla Customer se agrega al grupo Customer y las tablas OrderHeader y OrderDetail se agregan al grupo Order. Todas las tablas son de sólo descarga. Si una tabla ya existe en el cliente, se quitará y se volverá a crear durante la sincronización inicial. Para consultar este código en el contexto de un ejemplo completo, vea Filtrar filas y columnas.
//Create two SyncGroups so that changes to OrderHeader
//and OrderDetail are made in one transaction. Depending on
//application requirements, you might include Customer
//in the same group.
SyncGroup customerSyncGroup = new SyncGroup("Customer");
SyncGroup orderSyncGroup = new SyncGroup("Order");
//Add each table: specify a synchronization direction of
//DownloadOnly.
SyncTable customerSyncTable = new SyncTable("Customer");
customerSyncTable.CreationOption = TableCreationOption.DropExistingOrCreateNewTable;
customerSyncTable.SyncDirection = SyncDirection.DownloadOnly;
customerSyncTable.SyncGroup = customerSyncGroup;
this.Configuration.SyncTables.Add(customerSyncTable);
SyncTable orderHeaderSyncTable = new SyncTable("OrderHeader");
orderHeaderSyncTable.CreationOption = TableCreationOption.DropExistingOrCreateNewTable;
orderHeaderSyncTable.SyncDirection = SyncDirection.DownloadOnly;
orderHeaderSyncTable.SyncGroup = orderSyncGroup;
this.Configuration.SyncTables.Add(orderHeaderSyncTable);
SyncTable orderDetailSyncTable = new SyncTable("OrderDetail");
orderDetailSyncTable.CreationOption = TableCreationOption.DropExistingOrCreateNewTable;
orderDetailSyncTable.SyncDirection = SyncDirection.DownloadOnly;
orderDetailSyncTable.SyncGroup = orderSyncGroup;
this.Configuration.SyncTables.Add(orderDetailSyncTable);
'Create two SyncGroups so that changes to OrderHeader
'and OrderDetail are made in one transaction. Depending on
'application requirements, you might include Customer
'in the same group.
Dim customerSyncGroup As New SyncGroup("Customer")
Dim orderSyncGroup As New SyncGroup("Order")
'Add each table: specify a synchronization direction of
'DownloadOnly.
Dim customerSyncTable As New SyncTable("Customer")
customerSyncTable.CreationOption = TableCreationOption.DropExistingOrCreateNewTable
customerSyncTable.SyncDirection = SyncDirection.DownloadOnly
customerSyncTable.SyncGroup = customerSyncGroup
Me.Configuration.SyncTables.Add(customerSyncTable)
Dim orderHeaderSyncTable As New SyncTable("OrderHeader")
orderHeaderSyncTable.CreationOption = TableCreationOption.DropExistingOrCreateNewTable
orderHeaderSyncTable.SyncDirection = SyncDirection.DownloadOnly
orderHeaderSyncTable.SyncGroup = orderSyncGroup
Me.Configuration.SyncTables.Add(orderHeaderSyncTable)
Dim orderDetailSyncTable As New SyncTable("OrderDetail")
orderDetailSyncTable.CreationOption = TableCreationOption.DropExistingOrCreateNewTable
orderDetailSyncTable.SyncDirection = SyncDirection.DownloadOnly
orderDetailSyncTable.SyncGroup = orderSyncGroup
Me.Configuration.SyncTables.Add(orderDetailSyncTable)