OleDbConnectionStringBuilder コンストラクタとは何？わかりやすく解説 Weblio辞書

索引トップ用語の索引ランキング

OleDbConnectionStringBuilder コンストラクタ

OleDbConnectionStringBuilder クラスの新しいインスタンスを初期化します。接続文字列の使用
 オーバーロードの一覧

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

参照

その他の技術情報

Building Connection Strings
接続文字列の使用
接続文字列の使用

OleDbConnectionStringBuilder コンストラクタ (String)

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

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

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

Visual Basic (宣言)

Public Sub New ( _
    connectionString As String _
)

Visual Basic (使用法)

Dim connectionString As String

Dim instance As New OleDbConnectionStringBuilder(connectionString)

public OleDbConnectionStringBuilder (
    string connectionString
)

C++

public:
OleDbConnectionStringBuilder (
    String^ connectionString
)

public OleDbConnectionStringBuilder (
    String connectionString
)

JScript

public function OleDbConnectionStringBuilder
 (
    connectionString : String
)

パラメータ

connectionString: この情報を基にオブジェクトの内部的な接続情報が生成されます。この情報が解析され、キー/値のペアが生成されます。

例外

例外の種類	条件
ArgumentException	接続文字列が正しい書式になっていません。たとえば、キー/値ペアに "=" が欠落していることが考えられます。

解説

Provider プロパティを設定すると、直接 ConnectionString プロパティを設定するか、接続文字列をパラメータとしてコンストラクタに渡すかにかかわらず、OleDbConnectionStringBuilder インスタンス内に保持されるキー/値ペアに影響を与えます。たとえば、Provider プロパティを "sqloledb" に設定すると、標準的な SQL 接続文字列のプロパティがすべて追加されます。実際の例については、このトピックに示したコードを参照してください。

プロバイダによっては、OleDbConnectionStringBuilder コンストラクタ内に接続文字列を割り当てると、指定したキー/値ペアの順序が変更される場合があります。

使用例

次の例では、複数の OleDbConnectionStringBuilder インスタンスを作成し、それぞれの場合について異なる接続文字列をコンストラクタに渡しています。接続に使用するプロバイダを設定することによって、定義済みのキー/値ペアが、オブジェクトのコレクション内でどのように変わるかに注意してください。

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

メモ

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

Visual Basic

Imports System.Data.OleDb    

Module Module1
  Sub Main()
    Try
      ' Build an empty instance, just to see
      ' the contents of the keys.
      DumpBuilderContents("")

      ' Create a SQL Server connection string.
      DumpBuilderContents("Provider=sqloledb;Data Source=(local);"
 & _
       "Initial Catalog=AdventureWorks;" & _
       "User Id=ab;Password=Password@1")

      ' Create an Access connection string.
      DumpBuilderContents("Provider=Microsoft.Jet.OLEDB.4.0;"
 & _
       "Data Source=C:\Sample.mdb")

      ' Create an Oracle connection string.
      DumpBuilderContents("Provider=msdaora;Data Source=SomeOracleDb;"
 & _
       "User Id=userName;Password=Pass@word1;")

      ' Create a Sybase connection string.
      DumpBuilderContents("Provider=ASAProv;Data source=myASA")

      Console.WriteLine("Press any key to finish.")
      Console.ReadLine()

    Catch ex As System.ArgumentException
      Console.WriteLine("Error: " & ex.Message)
    End Try
  End Sub

  Private Sub DumpBuilderContents(ByVal
 connectString As String)
    Dim builder As New OleDbConnectionStringBuilder(connectString)
    Console.WriteLine("=================")
    Console.WriteLine("Original connectString   = "
 & connectString)
    Console.WriteLine("builder.ConnectionString = "
 & builder.ConnectionString)
    For Each key As String
 In builder.Keys
      Console.WriteLine(key & "=" & builder.Item(key).ToString)
    Next
  End Sub
End Module

using System.Data.OleDb;

class Program
{
    static void Main()
    {
        try
        {
            // Build an empty instance, just to see
            // the contents of the keys.
            DumpBuilderContents("");

            // Create a SQL Server connection string.
            DumpBuilderContents("Provider=sqloledb;Data Source=(local);"
 +
                "Initial Catalog=AdventureWorks;" +
                "User Id=ab;Password=Password@1");

            // Create an Access connection string.
            DumpBuilderContents("Provider=Microsoft.Jet.OLEDB.4.0;" +
                @"Data Source=C:\Sample.mdb");

            // Create an Oracle connection string.
            DumpBuilderContents("Provider=msdaora;Data Source=SomeOracleDb;"
 +
                "User Id=userName;Password=Pass@word1;");

            // Create an Sybase connection string.
            DumpBuilderContents("Provider=ASAProv;Data source=myASA");

            Console.WriteLine("Press any key to finish.");
            Console.ReadLine();

        }
        catch (System.ArgumentException ex)
        {

            Console.WriteLine("Error: " + ex.Message);
        }
    }

    private static void
 DumpBuilderContents(string connectString)
    {
        OleDbConnectionStringBuilder builder =
            new OleDbConnectionStringBuilder(connectString);
        Console.WriteLine("=================");
        Console.WriteLine("Original connectString   = " + connectString);
        Console.WriteLine("builder.ConnectionString = " + builder.ConnectionString);
        foreach (string key in
 builder.Keys)
        {
            Console.WriteLine(key + "=" + builder[key].ToString());
        }
    }
}

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

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

OleDbConnectionStringBuilder コンストラクタ ()