Метод 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.
- agentId
Тип: System.Int32
Исключения
Исключение | Условие |
---|---|
ApplicationException | When the profile represented by the object does not exist on the server. |
ArgumentException | When the value for distributionDBName is nullпустая ссылка (Nothing в Visual Basic), contains nullпустая ссылка (Nothing в Visual Basic) 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).
См. также
Справочник
Пространство имен Microsoft.SqlServer.Replication
Другие ресурсы
Работа с профилями агента репликации (программирование объектов RMO)