How to: Work with Replication Agent Profiles (RMO Programming)
Profile agent replikacja są używane do definiowania wartości domyślnych, gdy tworzony jest zadanie agenta.Każdy agent ma domyślny profil, a Niektórzy agenci są dodatkowe profile wstępnie zdefiniowane.Profile użytkownika można tworzyć przy użyciu RMO (replikacja Management Objects).Aby uzyskać więcej informacji na temat profili zobacz Replication Agent Profiles.
Aby utworzyć nowy profil agenta
Utwórz połączenie dystrybutor przy użyciu wystąpienie ServerConnection Klasa.
Utworzenie wystąpienie AgentProfile Klasa.
Ustaw następujące właściwości obiektu:
Name() -nazwę profilu.
AgentType() - AgentType Wartość określająca rodzaj agent replikacja, dla którego jest tworzony profil.
ConnectionContext() - ServerConnection utworzony w kroku 1.
(Opcjonalnie) Description() -Opis profilu.
(Opcjonalnie) Default() -zestaw tej właściwość true Jeśli wszystkie nowe zadania agenta to AgentType zastosuje ten profil domyślny.
Wywołanie Create() Metoda używana do tworzenia profilu na serwerze.
Gdy w profilu nie istnieje na serwerze, można go dostosować przez dodawanie, usuwanie i zmienianie wartości parametrów agent replikacja.
Aby przypisać profil do istniejącego zadanie agenta replikacja, należy skontaktować się telefonicznie AssignToAgent(String, Int32) Metoda. Nazwa baza danych dystrybucji do przekazania distributionDBName i identyfikator zadanie dla agentID.
Aby zmodyfikować istniejący profil agenta
Utwórz połączenie dystrybutor przy użyciu wystąpienie ServerConnection Klasa.
Utworzenie wystąpienie ReplicationServer Klasa. Przekazywanie ServerConnection Obiekt utworzony w kroku 1.
Wywołanie LoadProperties() Metoda. Jeśli ta metoda zwraca false, sprawdź, czy dystrybutor.
Wywołanie EnumAgentProfiles(AgentType) Metoda. Przekazywanie AgentType wartości do zawężenia zwracane profilów do określonego typu agent replikacja.
Żądane pobieranie AgentProfile obiekt z zwrócona ArrayList, gdzie Name() właściwość obiektu pasuje do nazwy profilu.
Jedną z następujących metod wywołania AgentProfile Aby zmienić profil:
AddParameter(String, String) -dodaje parametr obsługiwanych do profilu, gdzie name jest to nazwa parametru agent replikacja i value jest równa określonej wartości. Aby Wyświetla wszystkie parametry obsługiwane agenta agenta określonego typu, należy skontaktować się telefonicznie EnumParameterInfo() Metoda. Metoda zwraca ArrayList z AgentProfileParameterInfo obiekty reprezentujące wszystkie obsługiwanych parametrów.
RemoveParameter(String) -Usuwa istniejące parametrem z profilu, gdzie name jest to nazwa parametru agent replikacja. Aby Wyświetla wszystkie bieżące parametry agenta zdefiniowane dla tego profilu, należy skontaktować się telefonicznie EnumParameters() Metoda. Metoda zwraca ArrayList z AgentProfileParameter obiekty, które reprezentują istniejące parametru dla tego profilu.
ChangeParameter(String, String) -Zmienia ustawienie parametru istniejący profil, w którym name jest to nazwa parametru agenta i newValue jest to wartość, do którego został zmieniony w parametrze. Aby Wyświetla wszystkie bieżące parametry agenta zdefiniowane dla tego profilu, należy skontaktować się telefonicznie EnumParameters() Metoda. Metoda zwraca ArrayList z AgentProfileParameter obiekty, które reprezentują istniejące parametru dla tego profilu. Do wyliczenia wszystkich obsługiwanych ustawień parametrów agenta, zadzwoń EnumParameterInfo() Metoda. Metoda zwraca ArrayList z AgentProfileParameterInfo obiekty, które reprezentują obsługiwane wartości dla wszystkich parametrów.
Aby usunąć profil programu agent
Utwórz połączenie dystrybutor przy użyciu wystąpienie ServerConnection Klasa.
Utworzenie wystąpienie AgentProfile Klasa. Nazwa profilu dla zestaw Name() oraz ServerConnection w kroku 1 do ConnectionContext().
Wywołanie LoadProperties() Metoda. Jeśli ta metoda zwraca false, określona nazwa jest nieprawidłowa lub profil nie istnieje na serwerze.
Sprawdź, czy Type() Właściwość jest zestaw do User(), która wskazuje profil klienta. Nie należy usuwać profil, który ma wartość System() dla Type().
Wywołanie Remove() Metoda, aby usunąć profil użytkownika, reprezentowanych przez ten obiekt z serwera.