カスタム接続マネージャの作成

[アーティクル]
12/15/2008

新規 : 2006 年 4 月 14 日

カスタム接続マネージャを作成するために必要な手順は、Integration Services の他のカスタムオブジェクトの作成手順と同様です。

基本クラスを継承する新しいクラスを作成します。接続マネージャ用の基本クラスは ConnectionManagerBase です。
クラスに、オブジェクトの種類を識別する属性を適用します。接続マネージャ用の属性は DtsConnectionAttribute です。
基本クラスのメソッドとプロパティの実装をオーバーライドします。接続マネージャでは、ConnectionString プロパティ、AcquireConnection メソッド、および ReleaseConnection メソッドが対象です。
必要に応じて、カスタムユーザーインターフェイスを開発します。その場合、接続マネージャでは、IDtsConnectionManagerUI インターフェイスを実装するクラスが必要です。

カスタム接続マネージャの実際のサンプルについては、「SQL Server Custom Connection Manager サンプル」および「Excel2 Custom Connection Manager サンプル」を参照してください。このトピック内のコード例は、Sql Server Custom Connection Manager のサンプルに含まれています。

カスタム接続マネージャの概要

プロジェクトおよびクラスの作成

すべてのマネージ接続マネージャは ConnectionManagerBase 基本クラスから派生するため、カスタム接続マネージャを作成するには、最初に任意のマネージプログラミング言語でクラスライブラリプロジェクトを作成してから、基本クラスを継承するクラスを作成します。この派生クラスで、基本クラスのメソッドとプロパティをオーバーライドして、カスタム機能を実装します。

同じソリューション内に、もう 1 つのクラスライブラリプロジェクトをカスタムユーザーインターフェイス用に作成します。配置を容易にするため、ユーザーインターフェイス用に別個のアセンブリを使用することをお勧めします。そうすれば、接続マネージャやそのユーザーインターフェイスの更新や再配置を個別に行うことができます。

どちらのプロジェクトも、アセンブリに署名するよう構成します。アセンブリは、厳密な名前のキーファイルを使用して、ビルド時に生成されます。

DtsConnection 属性の適用

作成したクラスに DtsConnectionAttribute 属性を適用して、そのクラスが接続マネージャとして識別されるようにします。この属性には、接続マネージャの名前、説明、および接続の種類など、デザイン時の情報を指定します。ConnectionType プロパティと Description プロパティは、[SSIS 接続マネージャの追加] ダイアログボックスに表示される [種類] 列と [説明] 列に対応します。このダイアログボックスは、Business Intelligence Development Studio でパッケージの接続を構成するときに表示されます。

UITypeName プロパティを使用して、接続マネージャをそのカスタムユーザーインターフェイスにリンクします。このプロパティに必要な公開キートークンを取得するには、sn.exe -t を使用して、ユーザーインターフェイスアセンブリへの署名に使用するキーペア (.snk) ファイルから公開キートークンを表示します。

<DtsConnection(ConnectionType:="SQLVB", _
  DisplayName:="SqlConnectionManager (VB)", _
  Description:="Connection manager for Sql Server", _
  UITypeName:="SqlConnMgrUIVB.SqlConnMgrUIVB,SqlConnMgrUIVB,Version=1.0.0.0,Culture=neutral,PublicKeyToken=<insert public key token here>")> _
Public Class SqlConnMgrVB
  Inherits ConnectionManagerBase
  . . .
End Class

[DtsConnection(ConnectionType = "SQLCS",
  DisplayName = "SqlConnectionManager (CS)",
  Description = "Connection manager for Sql Server",
  UITypeName = "SqlConnMgrUICS.SqlConnMgrUICS,SqlConnMgrUICS,Version=1.0.0.0,Culture=neutral,PublicKeyToken=<insert public key token here>")]
public class SqlConnMgrCS :
ConnectionManagerBase
{
  . . .
}

カスタム接続マネージャのビルド、配置、およびデバッグ

Integration Services のカスタム接続マネージャをビルド、配置、およびデバッグする手順は、他の種類のカスタムオブジェクトの手順と同様です。詳細については、「カスタムオブジェクトのビルド、配置、およびデバッグ」を参照してください。

参照

処理手順

カスタム接続マネージャのコーディング
 カスタム接続マネージャ用ユーザーインターフェイスの開発

ヘルプおよび情報

SQL Server 2005 の参考資料の入手

次の方法で共有