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

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

建立 AgentProfile 類別的執行個體。

設定物件的下列屬性：

• Name - 設定檔的名稱。

• AgentType - AgentType 值，指定為其建立設定檔的複寫代理程式類型。

• ConnectionContext - 在步驟 1 中建立的 ServerConnection。

• (選擇性) Description - 設定檔的描述。

• (選擇性) Default - 如果依預設這個 AgentType 的所有新代理程式作業都會使用這個設定檔，請將此屬性設定為 true。

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

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

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

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

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

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

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

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

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

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

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

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

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

建立 AgentProfile 類別的執行個體。針對 ConnectionContext，設定步驟 1 的 Name 和 ServerConnection 的設定檔名稱。

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

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

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