Condividi tramite


AgentProfile.Name Property

Gets or sets the name of the replication agent profile.

Spazio dei nomi: Microsoft.SqlServer.Replication
Assembly : Microsoft.SqlServer.Rmo (in microsoft.sqlserver.rmo.dll)

Sintassi

'Dichiarazione
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)

Valore proprietà

A String value that specifies the name.

Eccezioni

Tipo di eccezione Condizione
ApplicationException

When you set Name for an existing profile.

ArgumentException

When the string value that is being set is null, contains null characters, or is longer than 128-Unicode characters.

Osservazioni

The Name property is a read/write property, and it is necessary to set this property before the object is created. Once the profile has been created on the server, this property cannot be changed.

The Name property can be retrieved only by members of the sysadmin fixed server role at the Distributor or by members of the replmonitor fixed database role.

The Name property can be set only by members of the sysadmin fixed server role at the Distributor when a new profile is being created on the server.

Retrieving Name is equivalent to executing sp_help_agent_profile (Transact-SQL).

Setting Name and calling Create is equivalent to executing sp_add_agent_profile (Transact-SQL).

The Name property is available with SQL Server 2005, SQL Server 2000, and SQL Server 7.0.

This namespace, class, or member is supported only in the .NET Framework 2.0.

Thread Safety

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Piattaforme

Piattaforme di sviluppo

Per un elenco delle piattaforme supportate, vedere Requisiti hardware e software per l'Installazione di SQL Server 2005.

Piattaforme di destinazione

Per un elenco delle piattaforme supportate, vedere Requisiti hardware e software per l'Installazione di SQL Server 2005.

Vedere anche

Riferimento

AgentProfile Class
AgentProfile Members
Microsoft.SqlServer.Replication Namespace

Altre risorse

How to: Work with Replication Agent Profiles (RMO Programming)