OracleConnectionStringBuilder コンストラクタ

.NET Framework クラス ライブラリ リファレンス

OracleConnectionStringBuilder コンストラクタ (String)

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

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

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

Visual Basic (宣言)

Public Sub New ( _
    connectionString As String _
)

Visual Basic (使用法)

Dim connectionString As String

Dim instance As New OracleConnectionStringBuilder(connectionString)

C#

public OracleConnectionStringBuilder (
    string connectionString
)

C++

public:
OracleConnectionStringBuilder (
    String^ connectionString
)

J#

public OracleConnectionStringBuilder (
    String connectionString
)

JScript

public function OracleConnectionStringBuilder
 (
    connectionString : String
)

パラメータ

connectionString

この情報を基にオブジェクトの内部的な接続情報が生成されます。この情報が解析され、名前/値のペアが生成されます。無効なキー名を指定すると、KeyNotFoundException が発生します。

例外

例外の種類	条件
KeyNotFoundException	接続文字列中に無効なキー名が含まれています。
FormatException	接続文字列中に無効な値が含まれています (特に、ブール値または数値を指定する必要がある箇所で、それらが指定されていない場合)。

解説

OracleConnectionStringBuilder クラスは、キー/値ペアの固定のコレクションを内部的に保持しています。このコンストラクタに対して接続文字列の値を部分的に指定した場合でも、オブジェクトからは常に各キー/値ペアの既定値が提供されます。このオブジェクトの ConnectionString プロパティで取得される文字列には、項目の既定値以外のキー/値ペアだけが格納されます。

使用例

次の例では、単純な接続文字列を、OracleConnectionStringBuilder オブジェクトのコンストラクタに指定し、そのオブジェクトに含まれたすべてのキー/値ペアを反復処理しています。このコレクションには、各項目の既定値が含まれる点に注意してください。また、OracleConnectionStringBuilder クラスは、常に一貫したキー名となるよう、既知のキーに対するシノニムが変換されます。

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

Visual Basic

' 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

C#

// 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);
        }
    }
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
OracleConnectionStringBuilder クラス
OracleConnectionStringBuilder メンバ
System.Data.OracleClient 名前空間
その他の技術情報
Building Connection Strings

OracleConnectionStringBuilder コンストラクタ

OracleConnectionStringBuilder クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

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

参照

関連項目

OracleConnectionStringBuilder クラス
OracleConnectionStringBuilder メンバ
System.Data.OracleClient 名前空間

その他の技術情報

Building Connection Strings

OracleConnectionStringBuilder コンストラクタ ()

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

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

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New OracleConnectionStringBuilder

C#

public OracleConnectionStringBuilder ()

C++

public:
OracleConnectionStringBuilder ()

J#

public OracleConnectionStringBuilder ()

JScript

public function OracleConnectionStringBuilder
 ()

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
OracleConnectionStringBuilder クラス
OracleConnectionStringBuilder メンバ
System.Data.OracleClient 名前空間
その他の技術情報
Building Connection Strings