AgentProfile.Name プロパティ
レプリケーション エージェント プロファイルの名前を取得します。値の設定も可能です。
名前空間: Microsoft.SqlServer.Replication
アセンブリ: Microsoft.SqlServer.Rmo (Microsoft.SqlServer.Rmo.dll)
構文
'宣言
Public Property Name As String
Get
Set
'使用
Dim instance As AgentProfile
Dim value As String
value = instance.Name
instance.Name = value
public string Name { get; set; }
public:
property String^ Name {
String^ get ();
void set (String^ value);
}
member Name : string with get, set
function get Name () : String
function set Name (value : String)
プロパティ値
型: System.String
名前を指定する String 値です。
例外
| 例外 | 条件 |
|---|---|
| ApplicationException | 既存のプロファイルに Name を設定すると発生します。 |
| ArgumentException | 設定する文字列値が nullNULL 参照 (Visual Basic では Nothing) であるか、nullNULL 参照 (Visual Basic では Nothing) 文字を含むか、128 Unicode 文字より長い場合に発生します。 |
説明
Name プロパティは、読み取り/書き込みプロパティです。よって、オブジェクトの作成前にこのプロパティを設定する必要があります。 プロファイルがサーバー上に作成された後は、このプロパティを変更できません。
Name プロパティを取得できるのは、ディストリビューター側の固定サーバー ロール sysadmin のメンバー、または固定データベース ロール replmonitor のメンバーだけです。
Name プロパティが設定できるのは、ディストリビューター側の固定サーバー ロール sysadmin のメンバーが、新しいプロファイルをそのサーバー上に作成するときだけです。
Name を取得すると、sp_help_agent_profile (Transact-SQL) を実行したのと同じことになります。
Name の設定と Create の呼び出しは、sp_add_agent_profile (Transact-SQL) を実行したのと同じことになります。
関連項目
参照
Microsoft.SqlServer.Replication 名前空間