AgentProfile.AddParameter Method

Adds a parameter to the replication agent profile.

命名空間: Microsoft.SqlServer.Replication
組件: Microsoft.SqlServer.Rmo (in microsoft.sqlserver.rmo.dll)

語法

'宣告
Public Sub AddParameter ( _
    name As String, _
    value As String _
)

public void AddParameter (
    string name,
    string value
)

public:
void AddParameter (
    String^ name, 
    String^ value
)

public void AddParameter (
    String name, 
    String value
)

public function AddParameter (
    name : String, 
    value : String
)

參數

• name
  A String value that specifies the name of a profile parameter.

• value
  A String value that specifies a value for the profile parameter.

例外

例外類型	狀況
ApplicationException	When the profile represented by the object does not exist on the server.
ArgumentException	When the name parameter is null, contains null characters, or is longer than 128-Unicode characters. When the value parameter is null, contains null characters or is longer than 255-Unicode characters.

備註

The parameter name and value are validated by the server. The profile must exist on the server before parameters can be added. Call EnumParameters to get the parameters that are currently defined for the profile.

The AddParameter method can be called only by a member of the sysadmin fixed server role at the Distributor. AddParameter is equivalent to executing sp_add_agent_parameter (Transact-SQL).

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

執行緒安全性

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.

平台

開發平台

如需受支援的平台清單，請參閱＜安裝 SQL Server 2005 的硬體和軟體需求＞。

目標平台

如需受支援的平台清單，請參閱＜安裝 SQL Server 2005 的硬體和軟體需求＞。

請參閱

參考

AgentProfile Class
AgentProfile Members
Microsoft.SqlServer.Replication Namespace

其他資源

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