Метод AddSubscription (репликация)
Приложения вызывают метод AddSubscription для создания новой анонимной подписки на существующую публикацию Microsoft SQL Server. После вызова метода AddSubscription приложение должно вызвать метод Synchronize для синхронизации новой подписки на публикацию.
Синтаксис
object.AddSubscription(DBADDOPTION)
Объект применения
Объект Replication SQL Server 2005 Compact Edition (SQL Server Compact Edition)
Параметры
| Параметр | Описание |
|---|---|
DBADDOPTION |
Задает способ создания новой подписки |
Параметр DBADDOPTION
Параметр DBADDOPTION задает способ создания новой подписки. В зависимости от перечисленных в таблице значений этот параметр определяет, создается ли новая база данных SQL Server Compact Edition либо используется существующая БД.
| Константа | Значение | Описание |
|---|---|---|
EXISTING_DATABASE |
0 |
Предполагается, что база данных SQL Server Compact Edition уже создана |
CREATE_DATABASE |
1 |
На устройстве создается новая база данных SQL Server Compact Edition (значение по молчанию) |
Если для параметра DBADDOPTION задано значение EXISTING_DATABASE, то предполагается, что база данных уже существует, но содержимое для нее следует получить из издателя. В этом случае методы AddSubscription, Synchronize создают подписку SQL Server Compact Edition и затем загружают содержимое базы данных из издателя SQL Server.
Поскольку одна база данных SQL Server Compact Edition может быть подписчиком на несколько публикаций, при применении значения EXISTING_DATABASE следует учитывать следующее обстоятельство. Если база данных уже существует и требуется добавить еще одну подписку, необходимо настроить свойства Publisher, Publication и PublisherDatabase перед вызовом метода AddSubscription.
Если для параметра DBADDOPTION задано значение CREATE_DATABASE, то подразумевается, что сначала должна быть создана база данных SQL Server Compact Edition, а затем следует получить содержимое подписки из издателя. В этом случае методы AddSubscription, Synchronize создают базу данных и подписку SQL Server Compact Edition и загружают содержимое базы данных из издателя SQL Server.
Прототип
HRESULT AddSubscription(DBADDOPTION DBAddOption);
Возвращаемые результаты
| Возвращаемый результат | Описание |
|---|---|
S_OK |
Метод выполнен успешно |
Любое значение FAILED(HRESULT) |
Подробные сведения об ошибке см. в коллекции SSCEErrors |
Замечания
Прежде чем приложение SQL Server Compact Edition сможет подписаться на публикацию и выполнить репликацию данных, администратор базы данных должен настроить SQL Server для обеспечения поддержки репликации слиянием и создать публикацию SQL Server, активированную для подписок SQL Server Compact Edition.
См. также
Справочник
Свойство Publisher (репликация)
Свойство Publication (репликация)
Свойство PublisherDatabase (репликация)