共用方式為


AgentProfile.AssignToAgent 方法

Assigns the replication agent profile to a specific replication agent job.

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

語法

'宣告
Public Sub AssignToAgent ( _
    distributionDBName As String, _
    agentId As Integer _
)
'用途
Dim instance As AgentProfile 
Dim distributionDBName As String 
Dim agentId As Integer

instance.AssignToAgent(distributionDBName, _
    agentId)
public void AssignToAgent(
    string distributionDBName,
    int agentId
)
public:
void AssignToAgent(
    String^ distributionDBName, 
    int agentId
)
member AssignToAgent : 
        distributionDBName:string * 
        agentId:int -> unit
public function AssignToAgent(
    distributionDBName : String, 
    agentId : int
)

參數

  • distributionDBName
    型別:System.String
    A String value that specifies the name of the distribution database used by the replication agent job.

例外狀況

例外狀況 條件
ApplicationException

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

ArgumentException

When the value for distributionDBName is nullnull 參考 (在 Visual Basic 中為 Nothing), contains nullnull 參考 (在 Visual Basic 中為 Nothing) characters, or is longer than 128-Unicode characters.

備註

A replication agent profile can be assigned to a replication agent job only after it has been created on the database, and it can be assigned only to an agent job for the correct type of replication agent.

Calling AssignToAgent loads profile properties from the server. Call CommitPropertyChanges to commit property changes before calling this method.

The AssignToAgent method can be called only by members of the sysadmin fixed server role at the Distributor.

Calling AssignToAgent is equivalent to executing sp_update_agent_profile (Transact-SQL).

請參閱

參考

AgentProfile 類別

Microsoft.SqlServer.Replication 命名空間

其他資源

使用複寫代理程式設定檔 (RMO 程式設計)