AddSubscription 方法 (複寫)
應用程式會呼叫 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 Compact 3.5 訂閱啟用的 SQL Server 發行集。