AgentProfile.AddParameter(String, String) メソッド

定義

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

レプリケーションエージェントプロファイルにパラメーターを追加します。

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)

プロファイルパラメーターの名前を指定する String 値です。

プロファイルパラメーターの値を指定する String 値です。

オブジェクトによって表されるプロファイルがサーバーに存在しない場合に発生します。

name パラメーターが null であるか、null 文字を含むか、128 Unicode 文字より長い場合に発生します。

value パラメーターが null であるか、null 文字を含むか、255 Unicode 文字より長い場合に発生します。

パラメーター名と値がサーバーによって検証されます。パラメーターを追加するには、サーバーにそのプロファイルが存在する必要があります。プロファイルに現在定義されているパラメーターを取得するには、EnumParameters を呼び出します。

AddParameter メソッドを呼び出すことができるのは、ディストリビューター側の固定サーバーロール sysadmin のメンバーだけです。 AddParameter は、 sp_add_agent_parameterの実行 (Transact-SQL) と同じです。