ConnectionManager.AcquireConnection(Object) メソッド

定義

名前空間:

Microsoft.SqlServer.Dts.Runtime

アセンブリ:

Microsoft.SqlServer.ManagedDTS.dll

接続の種類のインスタンスを作成します。

public:
 System::Object ^ AcquireConnection(System::Object ^ txn);

public object AcquireConnection (object txn);

member this.AcquireConnection : obj -> obj

Public Function AcquireConnection (txn As Object) As Object

パラメーター

txn

Object

トランザクションの種類へのハンドルです。

戻り値

Object

トランザクション接続を表すオブジェクトです。

例

次のコード例では、接続マネージャーに OLE DB 接続を追加し、接続を取得します。

// Create the package.  
Package pkg = new Package();  

// Add a ConnectionManager to the Connections collection.  
ConnectionManager connMgr = pkg.Connections.Add("ADO.NET:OLEDB");  
connMgr.Properties["RetainSameConnection"].SetValue(connMgr , true);  
connMgr.ConnectionString = connStr;  

// Aqcuire the connection.  
object connection = connMgr.AcquireConnection(null);  

' Create the package.  
Dim pkg As Package =  New Package()   

' Add a ConnectionManager to the Connections collection.  
Dim connMgr As ConnectionManager =  pkg.Connections.Add("ADO.NET:OLEDB")   
connMgr.Properties("RetainSameConnection").SetValue(connMgr , True)  
connMgr.ConnectionString = connStr  

' Aqcuire the connection.  
Dim connection As Object =  connMgr.AcquireConnection(Nothing)  

注釈

SupportsDTCTransactions プロパティが null である場合、transaction パラメーター txn には false を渡します。 SupportsDTCTransactions プロパティが true である場合、transaction パラメーターに null を渡して、コンテナーがトランザクションをサポートしているが参加しないことを示すことができます。