OdbcConnectionStringBuilder 建構函式

定義

命名空間:

System.Data.Odbc

組件:

System.Data.Odbc.dll

套件:

System.Data.Odbc v9.0.0-preview.5.24306.7

初始化 OdbcConnectionStringBuilder 類別的新執行個體。

多載

OdbcConnectionStringBuilder()	初始化 OdbcConnectionStringBuilder 類別的新執行個體。
OdbcConnectionStringBuilder(String)	初始化 OdbcConnectionStringBuilder 類別的新執行個體。 所提供的連接字串會提供執行個體內部連接資訊的資料。

OdbcConnectionStringBuilder()

來源:

OdbcConnectionStringbuilder.cs

初始化 OdbcConnectionStringBuilder 類別的新執行個體。

public:
 OdbcConnectionStringBuilder();

public OdbcConnectionStringBuilder ();

Public Sub New ()

另請參閱

• 連接字串產生器
• ADO.NET 中的連接字串

OdbcConnectionStringBuilder(String)

來源:

OdbcConnectionStringbuilder.cs

初始化 OdbcConnectionStringBuilder 類別的新執行個體。 所提供的連接字串會提供執行個體內部連接資訊的資料。

public:
 OdbcConnectionStringBuilder(System::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 屬性。 此行為任一方式都相同。

另請參閱

• 連接字串產生器
• ADO.NET 中的連接字串