AgentProfile.Name Property

レプリケーション エージェント プロファイルの名前を取得します。値の設定も可能です。

名前空間: Microsoft.SqlServer.Replication
アセンブリ: Microsoft.SqlServer.Rmo (microsoft.sqlserver.rmo.dll 内)

構文

'宣言
Public Property Name As String
public string Name { get; set; }
public:
property String^ Name {
    String^ get ();
    void set (String^ value);
}
/** @property */
public String get_Name ()

/** @property */
public void set_Name (String value)
public function get Name () : String

public function set Name (value : String)

プロパティ値

名前を指定する String 値です。

例外

例外の種類 条件
ApplicationException

既存のプロファイルに Name を設定すると発生します。

ArgumentException

設定する文字列値が null であるか、null 文字を含むか、128 Unicode 文字より長い場合に発生します。

解説

Name プロパティは、読み取り/書き込みプロパティです。よって、オブジェクトの作成前にこのプロパティを設定する必要があります。プロファイルがサーバー上に作成された後は、このプロパティを変更できません。

Name プロパティを取得できるのは、ディストリビュータ側の固定サーバー ロール sysadmin のメンバ、または固定データベース ロールreplmonitor のメンバだけです。

Name プロパティが設定できるのは、ディストリビュータ側の固定サーバー ロール sysadmin のメンバが、新しいプロファイルをそのサーバー上に作成するときだけです。

Name を取得すると、sp_help_agent_profile (Transact-SQL) を実行したのと同じことになります。

Name の設定と Create の呼び出しは、sp_add_agent_profile (Transact-SQL) を実行したのと同じことになります。

Name プロパティは、SQL Server 2005、SQL Server 2000、および SQL Server 7.0 で使用できます。

この名前空間、クラス、またはメンバは、.NET Framework 2.0 でのみサポートされています。

スレッド セーフ

この型の public static (Microsoft Visual Basic では共有 ) メンバは、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

開発プラットフォーム

サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。

対象プラットフォーム

サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。

参照

関連項目

AgentProfile Class
AgentProfile Members
Microsoft.SqlServer.Replication Namespace

その他の技術情報

レプリケーション エージェント プロファイルを扱う方法 (RMO プログラミング)