ConnectionManager.Properties Property

  • [アーティクル]

ConnectionManager のプロパティ オブジェクトのコレクションを取得します。これは、接続マネージャによってホストされている特定の接続のプロパティにアクセスするメソッドです。このプロパティは読み取り専用です。

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

構文

'宣言
Public ReadOnly Property Properties As DtsProperties

public DtsProperties Properties { get; }

public:
virtual property DtsProperties^ Properties {
    DtsProperties^ get () sealed;
}

/** @property */
public final DtsProperties get_Properties ()

public final function get Properties () : DtsProperties

プロパティ値

その接続の種類固有のプロパティを表す DtsProperties コレクションです。

解説

ConnectionManager から継承されるすべてのクラスには、同じプロパティおよびメソッドが含まれます。ただし、それぞれの接続の種類には、それぞれに固有の追加のプロパティがあります。コレクションから接続マネージャを取得し、プロパティを繰り返し処理したときに、ConnectionManager クラスに存在しないプロパティは、すべてその接続に固有のプロパティです。接続に対して一意であるが、ConnectionManager の一部ではないプロパティ (複数の接続にある RetainSameConnection プロパティなど) を設定するには、次のコード例を使用します。

ConnectionManager.Properties("RetainSameConnection") = True

使用可能な接続の種類の詳細については、「接続マネージャ」を参照してください。

使用例

次のコード例では、[0] のインデックス構文を使用している Connections コレクションの最初の接続マネージャから Properties コレクションを取得します。このサンプルでは、その後 Properties コレクションにあるプロパティの名前を書き込みます。

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

namespace ConnMgr_Properties_Collection
{
    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);
            Connections myConns = pkg.Connections;

            // Get the Properties collection from the connection
            // manager and iterate through the properties, 
            // printing the property names.
            ConnectionManager myConnMgr = myConns[0];
            DtsProperties connProperties = myConnMgr.Properties;

            foreach (DtsProperty connProp in connProperties)
                Console.WriteLine(connProp.Name);
        }
    }
}

Imports System
Imports System.Collections.Generic
Imports System.Text
Imports Microsoft.SqlServer.Dts.Runtime
 
Namespace ConnMgr_Properties_Collection
    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) 
            Dim myConns As Connections =  pkg.Connections 
 
            ' Get the Properties collection from the connection
            ' manager and iterate through the properties, 
            ' printing the property names.
            Dim myConnMgr As ConnectionManager =  myConns(0) 
            Dim connProperties As DtsProperties =  myConnMgr.Properties 
 
            Dim connProp As DtsProperty
            For Each connProp In connProperties
                Console.WriteLine(connProp.Name)
            Next
        End Sub
    End Class
End Namespace

サンプルの出力 :

ConnectionString

CreationName

Description

ID

InitialCatalog

Name

Password

ProtectionLevel

RetainSameConnection

ServerName

SupportsDTCTransactions

UserName

スレッド セーフ

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

プラットフォーム

開発プラットフォーム

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

対象プラットフォーム

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

参照

関連項目

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