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 プロパティが取得されると、文字列には、値が項目の既定値と異なるキーと値のペアのみが含まれます。

こちらもご覧ください

• 接続文字列の作成