AgentProfile.AddParameter(String, String) Methode

Referenz

Definition

Namespace:: Microsoft.SqlServer.Replication

Assembly:: Microsoft.SqlServer.Rmo.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Fügt dem Replikations-Agentprofil einen Parameter hinzu.

public:
 void AddParameter(System::String ^ name, System::String ^ value);

public void AddParameter (string name, string value);

member this.AddParameter : string * string -> unit

Public Sub AddParameter (name As String, value As String)

Parameter

name: String

Ein String-Wert, der den Namen eines Profilparameters angibt.

value: String

Ein String-Wert, der den Wert für den Profilparameter angibt.

Ausnahmen

ApplicationException

Wenn das durch das -Objekt dargestellte Profil auf dem Server nicht vorhanden ist.

ArgumentException

Wenn der name Parameter ist null, enthält null Zeichen oder ist länger als 128 Unicode-Zeichen.

Wenn der value Parameter ist null, enthält null Zeichen oder ist länger als 255 Unicode-Zeichen.

Hinweise

Der Parametername und -wert werden vom Server überprüft. Das Profil muss auf dem Server vorhanden sein, bevor Parameter hinzugefügt werden können. Rufen Sie EnumParameters auf, um die Parameter abzurufen, die derzeit für das Profil definiert sind.

Die AddParameter -Methode kann nur von einem Mitglied der sysadmin festen Serverrolle am Verteiler aufgerufen werden. AddParameterentspricht der Ausführung sp_add_agent_parameter (Transact-SQL).

Gilt für:

Weitere Informationen

Vorgehensweise: Arbeiten mit Agentprofilen (RMO-Programmierung)