Compartir a través de


Publication.ReplicateUserDefinedScript Method

Replicates the execution of a user-defined script to the Subscribers of a specified publication.

Espacio de nombres: Microsoft.SqlServer.Replication
Ensamblado: Microsoft.SqlServer.Rmo (in microsoft.sqlserver.rmo.dll)

Sintaxis

'Declaración
Public Sub ReplicateUserDefinedScript ( _
    scriptFilePath As String _
)
public void ReplicateUserDefinedScript (
    string scriptFilePath
)
public:
void ReplicateUserDefinedScript (
    String^ scriptFilePath
)
public void ReplicateUserDefinedScript (
    String scriptFilePath
)
public function ReplicateUserDefinedScript (
    scriptFilePath : String
)

Parámetros

  • scriptFilePath
    A String value that specifies the file name and full path to the Transact-SQL script file.

Excepciones

Tipo de excepción Condición
ApplicationException

The server is not running SQL Server 2000 or later.

ArgumentException

The passed String value is null, empty, or too long, or the path is not a valid path.

Notas

The ReplicateUserDefinedScript method is only supported for transactional and merge publications.

The script is copied to the Distributor when ReplicateUserDefinedScript is first invoked. The Distribution Agent or the Merge Agent then applies the copy at the Distributor to the Subscriber. Any modifications to the script after ReplicateUserDefinedScript will not be replicated. You will need to call this method again.

Using the ReplicateUserDefinedScript method to post a script file for publications using File Transfer Protocol (FTP) for snapshot delivery is only supported for SQL Server Subscribers.

The ReplicateUserDefinedScript method can only be called by members of the sysadmin fixed server role at the Publisher or by members of the db_owner fixed database role on the publication database.

Calling ReplicateUserDefinedScript is equivalent to executing the sp_addscriptexec (Transact-SQL) stored procedure.

The ReplicateUserDefinedScript method is available with SQL Server 2000, and SQL Server 2005.

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

Seguridad para subprocesos

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.

Plataformas

Plataformas de desarrollo

Para obtener una lista de las plataformas compatibles, vea Requisitos de hardware y software para instalar SQL Server 2005.

Plataformas de destino

Para obtener una lista de las plataformas compatibles, vea Requisitos de hardware y software para instalar SQL Server 2005.

Vea también

Referencia

Publication Class
Publication Members
Microsoft.SqlServer.Replication Namespace