SqlConnectionStringBuilder コンストラクタ

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

SqlConnectionStringBuilder コンストラクタ (String)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

SqlConnectionStringBuilder クラスの新しいインスタンスを初期化します。引数に渡した接続文字列によって、インスタンスの内部的な接続情報のデータが提供されます。

名前空間: System.Data.SqlClient
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    connectionString As String _
)

Visual Basic (使用法)

Dim connectionString As String

Dim instance As New SqlConnectionStringBuilder(connectionString)

C#

public SqlConnectionStringBuilder (
    string connectionString
)

C++

public:
SqlConnectionStringBuilder (
    String^ connectionString
)

J#

public SqlConnectionStringBuilder (
    String connectionString
)

JScript

public function SqlConnectionStringBuilder
 (
    connectionString : String
)

パラメータ

connectionString

この情報を基にオブジェクトの内部的な接続情報が生成されます。この情報が解析され、名前/値のペアが生成されます。無効なキー名を指定すると、KeyNotFoundException が発生します。

例外

例外の種類	条件
KeyNotFoundException	接続文字列中に無効なキー名が含まれています。
FormatException	接続文字列中に無効な値が含まれています (特に、ブール値または数値を指定する必要がある箇所で、それらが指定されていない場合)。

解説

SqlConnectionStringBuilder クラスは、キー/値ペアの固定のコレクションを内部的に保持しています。このコンストラクタに対して接続文字列の値を部分的に指定した場合でも、オブジェクトからは常に各キー/値ペアの既定値が提供されます。このオブジェクトの ConnectionString プロパティで取得される文字列には、項目の既定値以外のキー/値ペアだけが格納されます。

使用例

次の例では、SQL Server の単純な接続文字列を、SqlConnectionStringBuilder オブジェクトのコンストラクタに指定し、そのオブジェクトに含まれたすべてのキー/値ペアを反復処理しています。このコレクションには、各項目の既定値が含まれる点に注意してください。また、SqlConnectionStringBuilder クラスは、常に一貫したキー名となるよう、既知のキーに対するシノニムが変換されます。

メモ
この例には、SqlConnectionStringBuilder と接続文字列がどのように連携するかを示すパスワードが含まれています。アプリケーションでは、Windows 認証の使用をお勧めします。パスワードを使用する必要がある場合は、ハードコーディングされたパスワードをアプリケーションに組み込まないでください。

Visual Basic

Imports System.Data.SqlClient

Module Module1
    Sub Main()
        Try
            Dim connectString As String
 = _
                "Server=(local);Database=AdventureWorks;UID=ab;Pwd=a!Pass@@"
            Console.WriteLine("Original: " & connectString)
            Dim builder As New
 SqlConnectionStringBuilder(connectString)
            Console.WriteLine("Modified: " & builder.ConnectionString)
            For Each key As
 String In builder.Keys
                Console.WriteLine(key & "=" &
 builder.Item(key).ToString)
            Next
            Console.WriteLine("Press any key to finish.")
            Console.ReadLine()

        Catch ex As System.Collections.Generic.KeyNotFoundException
            Console.WriteLine("KeyNotFoundException: "
 & ex.Message)
        Catch ex As System.FormatException
            Console.WriteLine("Format exception: "
 & ex.Message)
        End Try
    End Sub
End Module 

C#

using System.Data.SqlClient;

class Program
{
    static void Main()
    {
        try
        {
            string connectString = 
                "Server=(local);Database=AdventureWorks;UID=ab;Pwd= a!Pass@@";
            Console.WriteLine("Original: " + connectString);
            SqlConnectionStringBuilder builder = 
                new SqlConnectionStringBuilder(connectString);
            Console.WriteLine("Modified: " + builder.ConnectionString);
            foreach (string key in
 builder.Keys)
                Console.WriteLine(key + "=" + builder[key].ToString());
            Console.WriteLine("Press any key to finish.");
            Console.ReadLine();

        }
        catch (System.Collections.Generic.KeyNotFoundException
 ex)
        {
            Console.WriteLine("KeyNotFoundException: " + ex.Message);
        }
        catch (System.FormatException ex)
        {
            Console.WriteLine("Format exception: " + ex.Message);
        }
    }
}

プラットフォーム

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

参照

関連項目
SqlConnectionStringBuilder クラス
SqlConnectionStringBuilder メンバ
System.Data.SqlClient 名前空間
その他の技術情報
接続文字列の使用

SqlConnectionStringBuilder コンストラクタ

SqlConnectionStringBuilder クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
SqlConnectionStringBuilder ()	SqlConnectionStringBuilder クラスの新しいインスタンスを初期化します。
SqlConnectionStringBuilder (String)	SqlConnectionStringBuilder クラスの新しいインスタンスを初期化します。引数に渡した接続文字列によって、インスタンスの内部的な接続情報のデータが提供されます。

参照

関連項目

SqlConnectionStringBuilder クラス
SqlConnectionStringBuilder メンバ
System.Data.SqlClient 名前空間

SqlConnectionStringBuilder コンストラクタ ()

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

SqlConnectionStringBuilder クラスの新しいインスタンスを初期化します。

名前空間: System.Data.SqlClient
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New SqlConnectionStringBuilder

C#

public SqlConnectionStringBuilder ()

C++

public:
SqlConnectionStringBuilder ()

J#

public SqlConnectionStringBuilder ()

JScript

public function SqlConnectionStringBuilder
 ()

プラットフォーム

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

参照

関連項目
SqlConnectionStringBuilder クラス
SqlConnectionStringBuilder メンバ
System.Data.SqlClient 名前空間