ConfigurationManager.ConnectionStrings プロパティ

.NET Framework クラス ライブラリ リファレンス

ConfigurationManager.ConnectionStrings プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

現在のアプリケーションの既定構成の ConnectionStringsSection データを取得します。

名前空間: System.Configuration
アセンブリ: System.Configuration (system.configuration.dll 内)
構文

Visual Basic (宣言)

Public Shared ReadOnly Property
 ConnectionStrings As ConnectionStringSettingsCollection

Visual Basic (使用法)

Dim value As ConnectionStringSettingsCollection

value = ConfigurationManager.ConnectionStrings

C#

public static ConnectionStringSettingsCollection
 ConnectionStrings { get; }

C++

public:
static property ConnectionStringSettingsCollection^ ConnectionStrings
 {
    ConnectionStringSettingsCollection^ get ();
}

J#

/** @property */
public static ConnectionStringSettingsCollection
 get_ConnectionStrings ()

JScript

public static function get
 ConnectionStrings () : ConnectionStringSettingsCollection

プロパティ値
現在のアプリケーションの既定構成の、ConnectionStringsSection オブジェクトの内容を格納する ConnectionStringSettingsCollection オブジェクトを返します。

例外

例外の種類	条件
ConfigurationErrorsException	ConnectionStringSettingsCollection オブジェクトを取得できませんでした。

解説

ConnectionStringsSection オブジェクトには、構成ファイルの connectionStrings セクションの内容が格納されます。

使用例

ConnectionStrings プロパティを使用して、名前付き接続文字列を取得する方法を次のコード例に示します。

Visual Basic

' Get connectionStrings.
Shared Sub GetConnectionStrings()
   ' Get the connectionStrings.
     Dim connectionStrings As _
     ConnectionStringSettingsCollection = _
     ConfigurationManager.ConnectionStrings
   
   ' Get the collection enumerator.
     Dim connectionStringsEnum As IEnumerator
 = _
     connectionStrings.GetEnumerator()
   
   ' Loop through the collection and 
   ' display the connectionStrings key, value pairs.
   Dim i As Integer = 0
   While connectionStringsEnum.MoveNext()
      Dim name As String
 = connectionStrings(i).Name
         Console.WriteLine("Name: {0} Value: {1}",
 _
         name, connectionStrings(name))
      i += 1
   End While
End Sub 'GetConnectionStrings

C#

// Get connectionStrings.
static void GetConnectionStrings()
{
    // Get the connectionStrings.
    ConnectionStringSettingsCollection connectionStrings =
         ConfigurationManager.ConnectionStrings;

    // Get the collection enumerator.
    IEnumerator connectionStringsEnum =
        connectionStrings.GetEnumerator();

    // Loop through the collection and 
    // display the connectionStrings key, value pairs.
    int i = 0;
    Console.WriteLine("Connection strings.");
    while (connectionStringsEnum.MoveNext())
    {
        string name = connectionStrings[i].Name;
        Console.WriteLine("Name: {0} Value: {1}",
        name, connectionStrings[name]);
        i += 1;
    }

}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ConfigurationManager クラス
ConfigurationManager メンバ
System.Configuration 名前空間
ConnectionStringsSection
ConnectionStringSettingsCollection
その他の技術情報
connectionStrings 要素 (ASP.NET 設定スキーマ)