ScriptComponent.AcquireConnections Method

Article
12/03/2008

Obtains a connection or connection information by using a connection manager.

Namespace: Microsoft.SqlServer.Dts.Pipeline
Assembly: Microsoft.SqlServer.TxScript (in microsoft.sqlserver.txscript.dll)

Syntax

'Declaration
Public Overridable Sub AcquireConnections ( _
    Transaction As Object _
)

public virtual void AcquireConnections (
    Object Transaction
)

public:
virtual void AcquireConnections (
    Object^ Transaction
)

public void AcquireConnections (
    Object Transaction
)

public function AcquireConnections (
    Transaction : Object
)

Parameters

Transaction
The transaction object to associate with the connection.

Remarks

The Script component developer does not use the ScriptComponent class directly, but indirectly, by coding the methods and properties of the ScriptMain class, which inherits from ScriptComponent through the UserComponent class.

The developer can override the AcquireConnections method in the ScriptMain class to connect to an external data source from a source or destination component.

Example

The following code sample demonstrates how the Script component developer might obtain a SqlConnection by using the AcquireConnections method. For more information, see Understanding the Script Component Object Model.

    Dim connMgr As IDTSConnectionManager90
    Dim sqlConn As SqlConnection

    Public Overrides Sub AcquireConnections(ByVal Transaction As Object)

        connMgr = Me.Connections.MyADONETConnection
        sqlConn = CType(connMgr.AcquireConnection(Nothing), SqlConnection)

    End Sub

Thread Safety

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.

Platforms

Development Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

Target Platforms