Compartir a través de


SyncGroup Clase

Representa un grupo de objetos SyncTable y proporciona un mecanismo para garantizar la coherencia en la aplicación de los cambios sobre esas tablas.

Espacio de nombres:  Microsoft.Synchronization.Data
Ensamblado:  Microsoft.Synchronization.Data (en Microsoft.Synchronization.Data.dll)

Sintaxis

'Declaración
<SerializableAttribute> _
Public Class SyncGroup
'Uso
Dim instance As SyncGroup
[SerializableAttribute]
public class SyncGroup
[SerializableAttribute]
public ref class SyncGroup
[<SerializableAttribute>]
type SyncGroup =  class end
public class SyncGroup

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)

Jerarquía de herencia

System. . :: . .Object
  Microsoft.Synchronization.Data..::..SyncGroup

Seguridad para subprocesos

Todos los miembros públicos static (Shared en Visual Basic) de este tipo son seguros para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Vea también

Referencia

SyncGroup Miembros

Microsoft.Synchronization.Data Espacio de nombres