Метод AddSubscription (репликация)

Статья
01/17/2011

Приложения вызывают метод AddSubscription для создания новой анонимной подписки на существующую публикацию MicrosoftSQL Server. После вызова метода AddSubscription приложение должно вызвать метод Synchronize для синхронизации новой подписки на публикацию.

Синтаксис

object.AddSubscription(DBADDOPTION)

Область применения

Объект SQL Server Compact 3.5 Replication

Параметры

Параметр	Описание
DBADDOPTION	Задает способ создания новой подписки

Параметр DBADDOPTION

Параметр DBADDOPTIONзадает способ создания новой подписки. В зависимости от перечисленных в таблице значений этот параметр определяет, создается ли новая база данных SQL Server Compact 3.5 либо используется существующая БД.

Константа	Значение	Описание
EXISTING_DATABASE	0	Предполагается, что база данных SQL Server Compact 3.5 уже создана.
CREATE_DATABASE	1	На устройстве создается новая база данных SQL Server Compact 3.5 (значение по молчанию)

Если для параметра DBADDOPTION задано значение EXISTING_DATABASE, то предполагается, что база данных уже существует, но содержимое для нее следует получить из издателя. В этом случае методы AddSubscription, Synchronize создают подписку SQL Server Compact 3.5 и затем загружают содержимое базы данных из издателя SQL Server.

Поскольку одна база данных SQL Server Compact 3.5 может быть подписчиком на несколько публикаций, при применении значения EXISTING_DATABASE следует учитывать следующее обстоятельство. Если база данных уже существует и требуется добавить еще одну подписку, необходимо настроить свойства Publisher, Publication и PublisherDatabase перед вызовом метода AddSubscription.

Если для параметра DBADDOPTION задано значение CREATE_DATABASE, то подразумевается, что сначала должна быть создана база данных SQL Server Compact 3.5, а затем следует получить содержимое подписки из издателя. В этом случае методы AddSubscription, Synchronize создают базу данных и подписку SQL Server Compact 3.5 и загружают содержимое базы данных из издателя SQL Server.

Прототип

HRESULT AddSubscription(DBADDOPTION DBAddOption);

Возвращаемые результаты

Возвращаемый результат	Описание
S_OK	Метод выполнен успешно.
Любое значение FAILED(HRESULT)	Подробные сведения об ошибке см. в коллекции SSCEErrors.

Замечания

Прежде чем приложение SQL Server Compact 3.5 сможет подписаться на публикацию и выполнить репликацию данных, администратор базы данных должен настроить SQL Server для обеспечения поддержки репликации слиянием и создать публикацию SQL Server, активированную для подписок SQL Server Compact 3.5.