OdbcConnectionStringBuilder コンストラクター

  • リファレンス

定義

名前空間:
System.Data.Odbc
アセンブリ:
System.Data.Odbc.dll
アセンブリ:
System.Data.dll
パッケージ:
System.Data.Odbc v8.0.1
パッケージ:
System.Data.Odbc v9.0.0-rc.2.24473.5

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

オーバーロード

OdbcConnectionStringBuilder()

OdbcConnectionStringBuilder クラスの新しいインスタンスを初期化します。
OdbcConnectionStringBuilder(String)

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

OdbcConnectionStringBuilder()

ソース:
OdbcConnectionStringbuilder.cs
ソース:
OdbcConnectionStringbuilder.cs

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

public:
 OdbcConnectionStringBuilder();
public OdbcConnectionStringBuilder ();
Public Sub New ()

こちらもご覧ください

適用対象

OdbcConnectionStringBuilder(String)

ソース:
OdbcConnectionStringbuilder.cs
ソース:
OdbcConnectionStringbuilder.cs

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

public:
 OdbcConnectionStringBuilder(System::String ^ connectionString);
public OdbcConnectionStringBuilder (string? connectionString);
public OdbcConnectionStringBuilder (string connectionString);
new System.Data.Odbc.OdbcConnectionStringBuilder : string -> System.Data.Odbc.OdbcConnectionStringBuilder
Public Sub New (connectionString As String)

パラメーター

connectionString
String

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

例外

ArgumentException

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

例

次の例では、複数OdbcConnectionStringBuilderのインスタンスを作成し、各ケースで異なる接続文字列をコンストラクターに渡します。 プロパティを取得ConnectionStringすると、接続文字列内の要素の順序が変更される場合があることに注意してください。 また、定義済みの "Dsn" キーと "Driver" キー以外のキーは、 クラスによって OdbcConnectionStringBuilder 小文字に変換されることにも注意してください。

注意

この例には、OdbcConnectionStringBuilder による接続文字列の操作方法を示すために、パスワードが含まれています。 実際のアプリケーションでは、Windows 認証を使用することをお勧めします。 パスワードを使用する必要がある場合も、ハードコードされたパスワードをアプリケーションに含めないでください。

using System.Data.Odbc;

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("Driver={SQL Server};Server=(local);Database=AdventureWorks;Uid=ab;Pwd=pass@word1");

            // Create an Access connection string.
            DumpBuilderContents(@"Driver={Microsoft Access Driver (*.mdb)};Dbq=C:\info.mdb;Exclusive=1;Uid=admin;Pwd=pass@word1");

            // Create an Oracle connection string.
            DumpBuilderContents("Driver={Microsoft ODBC for Oracle};Server=OracleServer.world;Uid=Admin;Pwd=pass@word1;");

            // Create a Sybase connection string.
            DumpBuilderContents("Driver={SYBASE ASE ODBC Driver};Srvr=SomeServer;Uid=admin;Pwd=pass@word1");

            Console.WriteLine("Press any key to finish.");
            Console.ReadLine();
        }
        catch (System.ArgumentException ex)
        {
            Console.WriteLine("Error: " + ex.Message);
        }
    }

    private static void DumpBuilderContents(string connectString)
    {
        OdbcConnectionStringBuilder builder =
            new OdbcConnectionStringBuilder(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());
        }
    }
}

Imports System.Data.Odbc    

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("Driver={SQL Server};Server=(local);Database=AdventureWorks;Uid=ab;Pwd=pass@word1")

      ' Create an Access connection string.
      DumpBuilderContents("Driver={Microsoft Access Driver (*.mdb)};Dbq=C:\info.mdb;Exclusive=1;Uid=admin;Pwd=pass@word1")

      ' Create an Oracle connection string.
      DumpBuilderContents("Driver={Microsoft ODBC for Oracle};Server=OracleServer.world;Uid=Admin;Pwd=pass@word1;")

      ' Create a Sybase connection string.
      DumpBuilderContents("Driver={SYBASE ASE ODBC Driver};Srvr=SomeServer;Uid=admin;Pwd=pass@word1")

      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 OdbcConnectionStringBuilder(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

注釈

コンストラクターで接続文字列を渡すことも、 プロパティを明示的にConnectionString設定することもできます。 動作はどちらの方法でも同じです。

こちらもご覧ください

適用対象