發行項
04/02/2012

AddParameter 方法

Adds a parameter to the replication agent profile.

命名空間： Microsoft.SqlServer.Replication
組件： Microsoft.SqlServer.Rmo (在 Microsoft.SqlServer.Rmo.dll 中)

語法

'宣告
Public Sub AddParameter ( _
    name As String, _
    value As String _
)
'用途
Dim instance As AgentProfile
Dim name As String
Dim value As String

instance.AddParameter(name, value)

public void AddParameter(
    string name,
    string value
)

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

member AddParameter : 
        name:string * 
        value:string -> unit

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

參數

name
型別：System. . :: . .String
A String value that specifies the name of a profile parameter.

value
型別：System. . :: . .String
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 Nothing nullptr unit null 參考 (在 Visual Basic 中為 Nothing) , contains null Nothing nullptr unit null 參考 (在 Visual Basic 中為 Nothing) characters, or is longer than 128-Unicode characters. When the value parameter is null Nothing nullptr unit null 參考 (在 Visual Basic 中為 Nothing) , contains null Nothing nullptr unit null 參考 (在 Visual Basic 中為 Nothing) characters or is longer than 255-Unicode characters.

ApplicationException

When the profile represented by the object does not exist on the server.

ArgumentException

When the name parameter is null Nothing nullptr unit null 參考 (在 Visual Basic 中為 Nothing) , contains null Nothing nullptr unit null 參考 (在 Visual Basic 中為 Nothing) characters, or is longer than 128-Unicode characters.

When the value parameter is null Nothing nullptr unit null 參考 (在 Visual Basic 中為 Nothing) , contains null Nothing nullptr unit null 參考 (在 Visual Basic 中為 Nothing) 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.