AgentProfile.AddParameter(String, String) Methode

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 Replikationsagentenprofil 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 einen Wert für den Profilparameter angibt.

Ausnahmen

ApplicationException

Wenn das vom Objekt dargestellte Profil auf dem Server nicht existiert.

ArgumentException

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

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

Hinweise

Parametername und Wert werden vom Server validiert. Das Profil muss auf dem Server existieren, bevor Parameter hinzugefügt werden können. Rufen Sie auf, EnumParameters um die aktuell für das Profil definierten Parameter zu erhalten.

Die Methode AddParameter kann nur von einem Mitglied der sysadmin festen Serverrolle beim Verteiler aufgerufen werden. AddParameter ist äquivalent zur Ausführung sp_add_agent_parameter (Transact-SQL).

Gilt für:

Weitere Informationen

Wie man: Mit Agentenprofilen arbeitet (RMO-Programmierung)