OracleConnectionStringBuilder 建構函式

定義

命名空間:

System.Data.OracleClient

組件:

System.Data.OracleClient.dll

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

多載

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

OracleConnectionStringBuilder()

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

public:
 OracleConnectionStringBuilder();

public OracleConnectionStringBuilder ();

Public Sub New ()

另請參閱

• 建置連接字串

OracleConnectionStringBuilder(String)

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

public:
 OracleConnectionStringBuilder(System::String ^ connectionString);

public OracleConnectionStringBuilder (string connectionString);

new System.Data.OracleClient.OracleConnectionStringBuilder : string -> System.Data.OracleClient.OracleConnectionStringBuilder

Public Sub New (connectionString As String)

參數

connectionString

String

物件內部連接資訊的基準。 剖析成名稱/值組。 無效索引鍵名稱會引發 KeyNotFoundException。

例外狀況

KeyNotFoundException

連接字串內無效的索引鍵名稱。

FormatException

連接字串中的無效值 (特別當必須是布林值或數值，但未提供這些值時)。

範例

下列範例會在物件的建構函式中OracleConnectionStringBuilder提供簡單的 連接字串，然後逐一查看物件內的所有索引鍵/值組。 請注意，集合會為每個專案提供預設值。 也請注意，OracleConnectionStringBuilder 類別會轉換已知索引鍵的同義資料表，使其與已知的名稱一致。

注意

這個範例包含了密碼，可示範 OracleConnectionStringBuilder 如何搭配連接字串使用。 我們建議在您的應用程式中使用 Windows 驗證。 如果您必須使用密碼，請勿在您的應用程式中包含硬式編碼的密碼。

// You may need to set a reference to the System.Data.OracleClient
// assembly before you can run this sample.
using System.Data.OracleClient;

class Program
{
    static void Main()
    {
        try
        {
            string connectString = "Server=OracleDemo;UID=Mary;Pwd=*****";
            Console.WriteLine("Original: " + connectString);
            OracleConnectionStringBuilder builder =
                new OracleConnectionStringBuilder(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);
        }
    }
}

' You may need to set a reference to the System.Data.OracleClient
' assembly before running this example.
Imports System.Data.OracleClient

Module Module1
  Sub Main()
    Try
      Dim connectString As String = "Server=OracleDemo;UID=Mary;Pwd=*****"
      Console.WriteLine("Original: " & connectString)
      Dim builder As New OracleConnectionStringBuilder(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

備註

OracleConnectionStringBuilder 類別會提供索引鍵/值組的固定內部集合。 即使您只在建構函式中提供可能連接字串值的少量子集，此物件一定會針對每一個索引鍵/值組提供預設值。 ConnectionString擷取物件的 屬性時，字串只會包含索引鍵/值組，其中的值與專案的預設值不同。

另請參閱

• 建置連接字串