Свойство SyncTable.CreationOption

Статья
10/17/2009

Возвращает или задает значение перечисления TableCreationOption, представляющее действие, которое должно быть выполнено при создании таблицы в клиентской базе данных.

Пространство имен: Microsoft.Synchronization.Data
Сборка: Microsoft.Synchronization.Data (в microsoft.synchronization.data.dll)

Синтаксис

'Декларация
Public Property CreationOption As TableCreationOption
'Применение
Dim instance As SyncTable
Dim value As TableCreationOption

value = instance.CreationOption

instance.CreationOption = value

public TableCreationOption CreationOption { get; set; }

public:
property TableCreationOption CreationOption {
    TableCreationOption get ();
    void set (TableCreationOption value);
}

/** @property */
public TableCreationOption get_CreationOption ()

/** @property */
public void set_CreationOption (TableCreationOption value)

public function get CreationOption () : TableCreationOption

public function set CreationOption (value : TableCreationOption)

Значение свойства

Значение перечисления TableCreationOption, представляющее действие, которое должно быть выполнено при создании таблиц в клиентской базе данных.

Замечания

Свойство TableCreationOption определяет порядок создания таблиц в клиентской базе данных (в частности, обработку ситуаций, когда в базе данных уже есть таблица с тем же именем). Дополнительные сведения см. в разделе Как инициализировать клиентскую базу данных и работать со схемой таблицы.

Пример

Следующий пример кода представляет собой класс, который является производным от класса SyncAgent. В коде создаются две группы и три таблицы синхронизации. Таблица Customer добавляется в группу Customer, а таблицы OrderHeader и OrderDetail — в группу Order. Все таблицы доступны только для загрузки. Если таблица существует на клиенте, при начальной синхронизации она будет удалена и создана повторно. Чтобы просмотреть этот код в контексте полного примера, см. раздел Как фильтровать строки и столбцы.

//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)

См. также

Справочник

Класс SyncTable
Элементы SyncTable
Пространство имен Microsoft.Synchronization.Data

Поделиться через