共用方式為


如何:使用複寫代理程式設定檔 (RMO 程式設計)

複寫代理程式設定檔是用來定義代理程式作業建立時的預設值。每一個代理程式都有預設的設定檔,有些代理程式還有其他預先定義的設定檔。您可以使用「複寫管理物件」(RMO) 建立使用者自訂的設定檔。如需有關設定檔的詳細資訊,請參閱<複寫代理程式設定檔>。

若要建立新的代理程式設定檔

  1. 使用 ServerConnection 類別的執行個體建立與「散發者」的連接。

  2. 建立 AgentProfile 類別的執行個體。

  3. 設定物件的下列屬性:

  4. 呼叫 Create 方法,以在伺服器上建立設定檔。

  5. 在伺服器上建立設定檔之後,就可以藉由加入、移除或變更複寫代理程式參數的值來加以自訂。

  6. 若要將設定檔指派給現有的複寫代理程式作業,請呼叫 AssignToAgent 方法。請針對 distributionDBName 傳遞散發資料庫的名稱,而針對 agentID 傳遞作業識別碼。

若要修改現有的代理程式設定檔

  1. 使用 ServerConnection 類別的執行個體建立與「散發者」的連接。

  2. 建立 ReplicationServer 類別的執行個體。傳遞在步驟 1 中建立的 ServerConnection 物件。

  3. 呼叫 LoadProperties 方法。如果此方法傳回 false,請確認「散發者」存在。

  4. 呼叫 EnumAgentProfiles 方法。傳遞 AgentType 值,將傳回的設定檔縮減為特定的複寫代理程式類型。

  5. 從傳回的 ArrayList 取得想要的 AgentProfile 物件,其中物件的 Name 屬性符合設定檔的名稱。

  6. 呼叫 AgentProfile 的下列其中一個方法來變更設定檔:

    • AddParameter - 將支援的參數加入至設定檔,其中 name 是複寫代理程式參數的名稱,value 則是指定的值。若要列舉給定代理程式類型的所有受支援的代理程式參數,請呼叫 EnumParameterInfo 方法。這個方法會傳回 AgentProfileParameterInfo 物件的 ArrayList,代表所有受支援的參數。

    • RemoveParameter - 從設定檔移除現有的參數,其中 name 是複寫代理程式參數的名稱。若要列舉所有目前為設定檔所定義的代理程式參數,請呼叫 EnumParameters 方法。這個方法會傳回 AgentProfileParameter 物件的 ArrayList,代表此設定檔的現有參數。

    • ChangeParameter - 變更設定檔中現有參數的設定,其中 name 是代理程式參數的名稱,而 newValue 則是參數要變更成的值。若要列舉所有目前為設定檔所定義的代理程式參數,請呼叫 EnumParameters 方法。這個方法會傳回 AgentProfileParameter 物件的 ArrayList,代表此設定檔的現有參數。若要列舉所有受支援的代理程式參數設定,請呼叫 EnumParameterInfo 方法。這個方法會傳回 AgentProfileParameterInfo 物件的 ArrayList,代表所有受支援的參數值。

若要刪除代理程式設定檔

  1. 使用 ServerConnection 類別的執行個體建立與「散發者」的連接。

  2. 建立 AgentProfile 類別的執行個體。針對 ConnectionContext,設定步驟 1 的 NameServerConnection 的設定檔名稱。

  3. 呼叫 LoadProperties 方法。如果此方法傳回 false,則指定的名稱不正確,或伺服器上不存在該設定檔。

  4. 確認 Type 屬性是設定為 User,這代表客戶的設定檔。您不該移除 Type 的值為 System 的設定檔。

  5. 呼叫 Remove 方法,從伺服器移除此物件代表的使用者自訂設定檔。