Connections.Add Method

指定した接続の種類の ConnectionManager オブジェクトを Connections コレクションに追加します。

名前空間: Microsoft.SqlServer.Dts.Runtime
アセンブリ: Microsoft.SqlServer.ManagedDTS (microsoft.sqlserver.manageddts.dll 内)

構文

'宣言
Public Function Add ( _
    connectionType As String _
) As ConnectionManager

public ConnectionManager Add (
    string connectionType
)

public:
ConnectionManager^ Add (
    String^ connectionType
)

public ConnectionManager Add (
    String connectionType
)

public function Add (
    connectionType : String
) : ConnectionManager

パラメータ

• connectionType
  このパラメータは、接続の種類を指定します。たとえば、文字列 "FILE" は、ファイルの接続マネージャを指定します。

戻り値

Connections コレクションに追加された、新しい ConnectionManager オブジェクトです。

解説

更新されたテキスト :2005 年 12 月 5 日

このメソッドの connectionType パラメータに使用される値は、デザイナの ConnectionManagerType プロパティに示される値です。SQL Server (SSIS) には、次のような接続マネージャの種類を含むいくつかの共通の接続の種類があります。

• Microsoft ActiveX Data Objects (ADO) オブジェクトにアクセスするための ADO

• ADO.NET オブジェクトにアクセスするための ADO.NET

• ファイルにアクセスするための FILE

• フラット ファイルのデータにアクセスするための FLATFILE

• Web サーバーにアクセスするための HTTP

• OLE DB を使用するリレーショナル データ ソースにアクセスするための OLEDB

• ODBC を使用するデータベースにアクセスするための ODBC

• サーバーにアクセスし、サーバーに管理スコープを指定するための Windows Management Instrumentation (WMI)

• ファイルを送受信するサーバーにアクセスするための FTP

• Microsoft SQL Server 2005 Analysis Services のインスタンスまたは Analysis Services プロジェクトにアクセスするための MSOLAP90

接続の種類を表す有効な文字列の詳細については、「接続マネージャ」を参照してください。

使用例

次のコード サンプルでは、2 つの既存の接続を含むパッケージに、ADO.NET 接続マネージャを追加します。

using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.SqlServer.Dts.Runtime;

namespace ConnMgr_GetEnum_Current
{
    class Program
    {
        static void Main(string[] args)
        {
            // The package is one of the SSIS Samples.
            string mySample = @"C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Package Samples\CalculatedColumns Sample\CalculatedColumns\CalculatedColumns.dtsx";
            // Create an application and load the sample.
            Application app = new Application();
            Package pkg = app.LoadPackage(mySample, null);

            // Get the Connections collection from the package.
            Connections conns = pkg.Connections;

            // Count the number of connections in the package.
            int myConns = conns.Count;
            Console.WriteLine("The number of connections is: {0}", myConns);

            //Add a new connection manager to the collection.
            conns.Add("ADO.NET");
            myConns = conns.Count;
            Console.WriteLine("The number of connections now is: {0}", myConns);
        }
    }
}

Imports System
Imports System.Collections.Generic
Imports System.Text
Imports Microsoft.SqlServer.Dts.Runtime
 
Namespace ConnMgr_GetEnum_Current
    Class Program
        Shared  Sub Main(ByVal args() As String)
            ' The package is one of the SSIS Samples.
            Dim mySample As String =  "C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Package Samples\CalculatedColumns Sample\CalculatedColumns\CalculatedColumns.dtsx" 
            ' Create an application and load the sample.
            Dim app As Application =  New Application() 
            Dim pkg As Package =  app.LoadPackage(mySample,Nothing) 
 
            ' Get the Connections collection from the package.
            Dim conns As Connections =  pkg.Connections 
 
            ' Count the number of connections in the package.
            Dim myConns As Integer =  conns.Count 
            Console.WriteLine("The number of connections is: {0}", myConns)
 
            'Add a new connection manager to the collection.
            conns.Add("ADO.NET")
            myConns = conns.Count
            Console.WriteLine("The number of connections now is: {0}", myConns)
        End Sub
    End Class
End Namespace

サンプルの出力 :

The number of connections is: 2

The number of connections now is: 3

スレッド セーフ

この型の public static (Microsoft Visual Basic では共有 ) メンバは、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

開発プラットフォーム

サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。

対象プラットフォーム

サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。

参照

関連項目

Connections Class
Connections Members
Microsoft.SqlServer.Dts.Runtime Namespace