ConnectionManager クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
データソースに接続するために必要な情報を提供します。 ConnectionManagerから継承するすべてのクラスは同じプロパティとメソッドを含みます。 ConnectionManagerクラスは、異なる接続タイプの実装詳細をランタイムから分離します。 これにより、ランタイムは各接続マネージャーと一貫性があり予測可能な方法でやり取りできます。 接続マネージャーは、 Name、 ID、 Description、 ConnectionStringなど、すべての接続に共通するストックプロパティのセットを含みます。 しかし、各接続タイプにはその接続タイプ固有の追加のプロパティがあります。 これらは Properties コレクションを通じてアクセス可能です。このクラスは継承できません。
public ref class ConnectionManager sealed : Microsoft::SqlServer::Dts::Runtime::DtsObject, IDisposable, Microsoft::SqlServer::Dts::Runtime::IDTSExecutionPath, Microsoft::SqlServer::Dts::Runtime::IDTSName, Microsoft::SqlServer::Dts::Runtime::IDTSObjectHost, Microsoft::SqlServer::Dts::Runtime::IDTSPackagePath, Microsoft::SqlServer::Dts::Runtime::IDTSPersist, Microsoft::SqlServer::Dts::Runtime::IDTSPropertiesProvider, Microsoft::SqlServer::Dts::Runtime::IDTSPropertiesProviderEx, System::ComponentModel::IComponent
public sealed class ConnectionManager : Microsoft.SqlServer.Dts.Runtime.DtsObject, IDisposable, Microsoft.SqlServer.Dts.Runtime.IDTSExecutionPath, Microsoft.SqlServer.Dts.Runtime.IDTSName, Microsoft.SqlServer.Dts.Runtime.IDTSObjectHost, Microsoft.SqlServer.Dts.Runtime.IDTSPackagePath, Microsoft.SqlServer.Dts.Runtime.IDTSPersist, Microsoft.SqlServer.Dts.Runtime.IDTSPropertiesProvider, Microsoft.SqlServer.Dts.Runtime.IDTSPropertiesProviderEx, System.ComponentModel.IComponent
type ConnectionManager = class
inherit DtsObject
interface IDTSObjectHost
interface IDTSPersist
interface IDTSName
interface IComponent
interface IDisposable
interface IDTSPropertiesProvider
interface IDTSPropertiesProviderEx
interface IDTSPackagePath
interface IDTSExecutionPath
Public NotInheritable Class ConnectionManager
Inherits DtsObject
Implements IComponent, IDisposable, IDTSExecutionPath, IDTSName, IDTSObjectHost, IDTSPackagePath, IDTSPersist, IDTSPropertiesProvider, IDTSPropertiesProviderEx
- 継承
- 実装
注釈
コネクションマネージャーは、コネクションの論理的な表現です。 設計段階では、グラフィカルユーザーインターフェースでは、パッケージが実行される際にランタイムが生成する物理的な接続を記述するために接続マネージャーを使用します。 インテグレーションサービスは、パッケージがさまざまなデータソースに接続できるようにするためのさまざまな種類の接続マネージャーを提供します。 例えば、ActiveXデータオブジェクト(ADO)接続マネージャー、ADO.NET接続マネージャー、ODBC接続マネージャーなどがあります。 詳細については 、「カスタムオブジェクトでパッケージを拡張する」をご覧ください。
プロパティ
| 名前 | 説明 |
|---|---|
| ConnectionString |
データソースへの接続を確立するために使われる接続文字列を取得したり設定したりします。 |
| CreationName |
ランタイムで ConnectionManager オブジェクトのインスタンスを作成し、 Connections コレクションに追加するために使われる文字列を返します。 このプロパティは読み取り専用です。 |
| DelayValidation |
パッケージ検証が実行されるまで遅延するかどうかを示すブール値を取得または設定します。 |
| Description |
ConnectionManagerオブジェクトの記述を取得するか設定します。 |
| HasExpressions |
接続マネージャーが式でプロパティを設定しているかどうかを示す値が得られます。 |
| HostType |
接続が使われているホストの種類を記述する列挙を受け取ります。 このプロパティは読み取り専用です。 |
| ID |
ConnectionManagerのIDを手に入れた。 このプロパティは読み取り専用です。 |
| InnerObject |
作成された特定の接続タイプを返します。 このプロパティは読み取り専用です。 |
| Name |
ConnectionManager オブジェクトの名前を取得または設定します。 |
| OfflineMode |
接続マネージャーがオフラインモードかどうかを示す値を取得または設定します。 |
| Properties |
ConnectionManagerのプロパティオブジェクトの集合を取得します。 これは、接続マネージャーがホストしている特定の接続のプロパティにアクセスする方法です。 このプロパティは読み取り専用です。 |
| ProtectionLevel |
パッケージに含まれる機密データに対して行われる暗号化レベルを取得するか設定します。 |
| Qualifier |
接続マネージャーの条件付けを取得または設定します。 |
| Scope |
接続マネージャーの範囲を得られます。 |
| Site |
接続マネージャーのサイトを取得するか設定します。 |
| SupportsDTCTransactions |
接続がMicrosoft 分散トランザクション コーディネーター(MS DTC)トランザクションをサポートしているかどうかを示すブール値を返します。 |
| VariableDispenser |
接続マネージャーで変数の分配器を取得します。 |
| Variables |
接続マネージャーで変数の集合を取得します。 |
メソッド
| 名前 | 説明 |
|---|---|
| AcquireConnection(Object) |
接続タイプのインスタンスを作成します。 |
| Dispose() |
ConnectionManagerによって使用されるリソースを解放します。 |
| Equals(Object) |
2 つのオブジェクト インスタンスが等しいかどうかを判断します。 (継承元 DtsObject) |
| GetExecutionPath() |
接続マネージャーの実行経路を返します。 |
| GetExpression(String) |
指定されたプロパティの表現を含むStringを返します。 nullとは、どの式も割り当てられていないことを意味します。 |
| GetHashCode() |
このインスタンスのハッシュ コードを返します。 (継承元 DtsObject) |
| GetPackagePath() |
接続が適用されるパッケージの経路を取得するか設定します。 |
| LoadFromXML(String, IDTSEvents) |
このメソッドはアプリケーションコードでは呼び出せません。 .xmlとして保存されたパッケージを読み込むには、 LoadPackage(String, IDTSEvents) メソッドを使います。 |
| LoadFromXML(XmlNode, IDTSEvents) |
このメソッドはアプリケーションコードでは呼び出せません。 .xmlとして保存されたパッケージを読み込むには、 LoadPackage(String, IDTSEvents) メソッドを使います。 |
| ReleaseConnection(Object) |
AcquireConnection(Object)中に確立された接続を解放します。 設計時と実行時に呼び出しられます。 |
| SaveToXML(XmlDocument, XmlNode, IDTSEvents) |
このメソッドはアプリケーションコードでは呼び出せません。 パッケージを .xmlとして保存するには、 SaveToXml(String, Package, IDTSEvents) メソッドを使います。 |
| SetExpression(String, String) |
指定された式をプロパティに割り当てます。 nullを指定して、プロパティから既存の式を削除します。 |
| SetQualifier(String) |
接続マネージャーが作成された後、実行中のパッケージで使用される前に、接続マネージャーの修飾子を変更します。 |
イベント
| 名前 | 説明 |
|---|---|
| Disposed |
ConnectionManagerのイベントを聞くためのイベントハンドラを追加Disposed。 |