AgentProfile.AssignToAgent Method

Article
12/15/2008

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

Espace de noms: Microsoft.SqlServer.Replication
Assembly: Microsoft.SqlServer.Rmo (in microsoft.sqlserver.rmo.dll)

Syntaxe

'Déclaration
Public Sub AssignToAgent ( _
    distributionDBName As String, _
    agentId As Integer _
)

public void AssignToAgent (
    string distributionDBName,
    int agentId
)

public:
void AssignToAgent (
    String^ distributionDBName, 
    int agentId
)

public void AssignToAgent (
    String distributionDBName, 
    int agentId
)

public function AssignToAgent (
    distributionDBName : String, 
    agentId : int
)

Paramètres

distributionDBName
A String value that specifies the name of the distribution database used by the replication agent job.

agentId

Exceptions

Type d'exception	Condition
ApplicationException	When the profile represented by the object does not exist on the server.
ArgumentException	When the value for distributionDBName is null, contains null characters, or is longer than 128-Unicode characters.

Notes

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).

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

Sécurité des threads

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.

Plateformes

Plateformes de développement

Pour obtenir la liste des plateformes prises en charge, consultez Configuration matérielle et logicielle requise pour l'installation de SQL Server 2005.

Plateformes cibles

Pour obtenir la liste des plateformes prises en charge, consultez Configuration matérielle et logicielle requise pour l'installation de SQL Server 2005.

Voir aussi

Référence

AgentProfile Class
AgentProfile Members
Microsoft.SqlServer.Replication Namespace

Autres ressources

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

Partager via