IDTSRuntimeConnection100.ConnectionManager プロパティ
ランタイム接続オブジェクトによって参照されている IDTSConnectionManager100 オブジェクトを取得します。値の設定も可能です。
名前空間: Microsoft.SqlServer.Dts.Pipeline.Wrapper
アセンブリ: Microsoft.SqlServer.DTSPipelineWrap (Microsoft.SqlServer.DTSPipelineWrap.dll)
構文
'宣言
Property ConnectionManager As IDTSConnectionManager100
Get
Set
'使用
Dim instance As IDTSRuntimeConnection100
Dim value As IDTSConnectionManager100
value = instance.ConnectionManager
instance.ConnectionManager = value
IDTSConnectionManager100 ConnectionManager { get; set; }
property IDTSConnectionManager100^ ConnectionManager {
IDTSConnectionManager100^ get ();
void set (IDTSConnectionManager100^ value);
}
abstract ConnectionManager : IDTSConnectionManager100 with get, set
function get ConnectionManager () : IDTSConnectionManager100
function set ConnectionManager (value : IDTSConnectionManager100)
プロパティ値
型: Microsoft.SqlServer.Dts.Runtime.Wrapper.IDTSConnectionManager100
コンポーネントの IDTSConnectionManager100 です。
説明
ConnectionManager プロパティは、パッケージに含まれている IDTSConnectionManager100 オブジェクトの実際のインスタンスへの参照を格納、または設定します。 実行時に、この参照は SSIS ランタイム エンジンによって ConnectionManagerID プロパティを使用して自動的に設定されます。これにより、パッケージ内で接続を検索したり、参照を割り当てることが可能になります。
デザイン時に、SSIS デザイナーは、コンポーネントを読み込んで初期化する際、この割り当てを実行します。 ただし、デザイナーの外部にあるオブジェクト モデルを使用し、プログラムでコンポーネントを読み込んで編集する場合は、プロパティを明示的に設定する必要があります。 パッケージの Connections コレクションがコンポーネントに公開されないので、コンポーネントは ConnectionManagerID プロパティを使用して明示的に接続を参照することはできません。
使用例
次のコード例は、パッケージをプログラムによって読み込む場合の ConnectionManager プロパティを設定しています。
// TODO: Replace the path to the package with a valid path.
string package = @"c:\Package.dtsx";
// Create the application and load the package.
Application a = new Application();
Package p = a.LoadPackage( package , null );
// Walk the Executables collection looking for data flow tasks.
foreach (Executable e in p.Executables)
{
MainPipe mp = ((TaskHost)e).InnerObject as MainPipe;
if( e != null )
{
// Walk the components.
foreach( IDTSComponentMetaData100 md in mp.ComponentMetaDataCollection )
{
// Walk the RuntimeConnectionCollection.
foreach( IDTSRuntimeConnection100 rc in md.RuntimeConnectionCollection )
{
// Check to see if the package's connections collection contains the
// Connectionmanager stored in the RuntimeConnection.
if (p.Connections.Contains(rc.ConnectionManagerID))
rc.ConnectionManager = DtsConvert.ToConnectionManager100(p.Connections[rc.ConnectionManagerID]);
else
Console.WriteLine("The ConnectionManager " + rc.ConnectionManagerID + " was not found in the Package's Connections collection.");
}
}
}
}
' TODO: Replace the path to the package with a valid path.
Dim package As String = "c:\Package.dtsx"
' Create the application and load the package.
Dim a As Application = New Application
Dim p As Package = a.LoadPackage(package, Nothing)
' Walk the Executables collection looking for data flow tasks.
For Each e As Executable In p.Executables
Dim mp As MainPipe = CType(CType(e, TaskHost).InnerObject, MainPipe)
If Not (e Is Nothing) Then
' Walk the components.
For Each md As IDTSComponentMetaData100 In mp.ComponentMetaDataCollection
' Walk the RuntimeConnectionCollection.
For Each rc As IDTSRuntimeConnection100 In md.RuntimeConnectionCollection
' Check to see whether the package's connections collection
' contains the Connectionmanager stored in the RuntimeConnection.
If p.Connections.Contains(rc.ConnectionManagerID) Then
rc.ConnectionManager = DtsConvert.ToConnectionManager100(p.Connections(rc.ConnectionManagerID))
Else
Console.WriteLine("The ConnectionManager " + rc.ConnectionManagerID + " was not found in the Package's Connections collection.")
End If
Next
Next
End If
Next