OracleConnectionStringBuilder クラス
アセンブリ: System.Data.OracleClient (system.data.oracleclient.dll 内)


接続文字列ビルダにより、クラスのプロパティとメソッドを使用して、構文的に正確な接続文字列をプログラムで作成したり、既存の接続文字列を解析および再構築したりできます。接続文字列ビルダは、Oracle がサポートする既知のキー/値ペアに対応した、厳密に型指定されたプロパティを提供します。OracleConnectionStringBuilder クラスは、ICustomTypeDescriptor インターフェイスを実装します。つまり、このクラスは、Visual Studio .NET デザイナでデザイン時に使用されます。Visual Studio .NET で、開発者がデザイナを使用して厳密に型指定された DataSets と厳密に型指定された接続をビルドした場合、厳密に型指定された接続文字列のビルダ クラスは、その型に関連付けられたプロパティを表示します。また、このクラスは、コンバータを使用して既知のキーの共通値を割り当てることもできます。
接続文字列をアプリケーション内で生成する必要がある場合、OracleConnectionStringBuilder クラスを使用して、接続文字列を生成および修正できます。また、OracleConnectionStringBuilder クラスを利用することで、アプリケーションの構成ファイルに格納される接続文字列の管理が容易になります。
OracleConnectionStringBuilder では、キー/値ペアが有効であるかどうかのチェックが実行されます。そのため、このクラスは、無効な接続文字列の作成には使用できません。無効なペアを追加しようとすると、例外がスローされます。OracleConnectionStringBuilder クラスは、一連のシノニムに対する固定のコレクションを保持しており、必要がある場合は、シノニムから対応する既知のキー名への変換を実行できます。Item プロパティで、必要なキーに対応するシノニムを含んだ文字列を指定することによって値を取得できます。サポートされるすべてのシノニムの一覧については、Item プロパティのトピックを参照してください。
OracleConnectionStringBuilder は、不正なエントリの挿入が試みられた場合も、適切に処理します。たとえば、次のコードでは、既定の Item プロパティ (C# ではインデクサ) を使用することで、入れ子になったキー/値ペアが適切にエスケープされています。
Dim builder As New System.Data. _ OracleClient.OracleConnectionStringBuilder builder("Data Source") = "OracleDemo" builder("Integrated Security") = True builder("User ID") = "Mary;NewValue=Bad" System.Diagnostics.Debug.WriteLine(builder.ConnectionString)
[C#]
System.Data.OracleClient.OracleConnectionStringBuilder builder = new System.Data.OracleClient.OracleConnectionStringBuilder(); builder["Data Source"] = "OracleDemo"; builder["integrated Security"] = true; builder["User ID"] = "Mary;NewValue=Bad"; System.Diagnostics.Debug.WriteLine(builder.ConnectionString);

次のコンソール アプリケーションでは、Oracle データベースで使用される接続文字列を作成します。このコードでは、OracleConnectionStringBuilder クラスを使用して接続文字列を作成し、OracleConnectionStringBuilder インスタンスの ConnectionString プロパティを、接続クラスのコンストラクタに渡しています。また、既存の接続文字列を解析し、接続文字列の内容に対して各種の操作を行う例が示されています。
![]() |
---|
この例には、OracleConnectionStringBuilder と接続文字列がどのように連携するかを示すパスワードが含まれています。アプリケーションでは、Windows 認証の使用をお勧めします。パスワードを使用する必要がある場合は、ハードコーディングされたパスワードをアプリケーションに組み込まないでください。 |
' 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() ' Create a new OracleConnectionStringBuilder and ' initialize it with a few name/value pairs. Dim builder As New OracleConnectionStringBuilder(GetConnectionString()) ' Note that the input connection string used the ' Server key, but the new connection string uses ' the well-known Data Source key instead. Console.WriteLine(builder.ConnectionString) ' Pass the OracleConnectionStringBuilder an existing ' connection string, and you can retrieve and ' modify any of the elements. builder.ConnectionString = _ "server=OracleDemo;user id=Mary;" & _ "password=*****" ' Now that the connection string has been parsed, ' you can work with individual items. Console.WriteLine(builder.Password) builder.Password = "newPassword" builder.PersistSecurityInfo = True ' You can refer to connection keys using strings, ' as well. When you use this technique (the default ' Item property in Visual Basic, or the indexer in C#), ' you can specify any synonym for the connection string key ' name. builder("Server") = "NewDemo" builder("Load Balance Timeout") = 1000 ' The Item property is the default for the class, ' and setting the Item property adds the value to the ' dictionary, if necessary. builder.Item("Integrated Security") = True Console.WriteLine(builder.ConnectionString) Console.WriteLine("Press Enter to finish.") Console.ReadLine() End Sub Private Function GetConnectionString() As String ' To avoid storing the connection string in your code, ' you can retrieve it from a configuration file. Return "Server=OracleDemo;Integrated Security=True;" & _ "Unicode=True" End Function End Module
// 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() { // Create a new OracleConnectionStringBuilder and // initialize it with a few name/value pairs. OracleConnectionStringBuilder builder = new OracleConnectionStringBuilder(GetConnectionString()); // Note that the input connection string used the // Server key, but the new connection string uses // the well-known Data Source key instead. Console.WriteLine(builder.ConnectionString); // Pass the OracleConnectionStringBuilder an existing // connection string, and you can retrieve and // modify any of the elements. builder.ConnectionString = "server=OracleDemo;user id=maryc;" + "password=pass@word1"; // Now that the connection string has been parsed, // you can work with individual items. Console.WriteLine(builder.Password); builder.Password = "newPassword"; builder.PersistSecurityInfo = true; // You can refer to connection keys using strings, // as well. When you use this technique (the default // Item property in Visual Basic, or the indexer in C#), // you can specify any synonym for the connection string key // name. builder["Server"] = "."; builder["Load Balance Timeout"] = 1000; builder["Integrated Security"] = true; Console.WriteLine(builder.ConnectionString); Console.WriteLine("Press Enter to finish."); Console.ReadLine(); } private static string GetConnectionString() { // To avoid storing the connection string in your code, // you can retrieve it from a configuration file. return "Server=OracleDemo;Integrated Security=true"; } }

System.Data.Common.DbConnectionStringBuilder
System.Data.OracleClient.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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


OracleConnectionStringBuilder コンストラクタ ()
アセンブリ: System.Data.OracleClient (system.data.oracleclient.dll 内)


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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


OracleConnectionStringBuilder コンストラクタ (String)
アセンブリ: System.Data.OracleClient (system.data.oracleclient.dll 内)



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

次の例では、単純な接続文字列を、OracleConnectionStringBuilder オブジェクトのコンストラクタに指定し、そのオブジェクトに含まれたすべてのキー/値ペアを反復処理しています。このコレクションには、各項目の既定値が含まれる点に注意してください。また、OracleConnectionStringBuilder クラスは、常に一貫したキー名となるよう、既知のキーに対するシノニムが変換されます。
![]() |
---|
この例には、OracleConnectionStringBuilder と接続文字列がどのように連携するかを示すパスワードが含まれています。アプリケーションでは、Windows 認証の使用をお勧めします。パスワードを使用する必要がある場合は、ハードコーディングされたパスワードをアプリケーションに組み込まないでください。 |
' 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
// 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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


OracleConnectionStringBuilder コンストラクタ

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

OracleConnectionStringBuilder プロパティ

名前 | 説明 | |
---|---|---|
![]() | BrowsableConnectionString | ConnectionString プロパティが Visual Studio デザイナに表示できるかどうかを指定する値を取得または設定します。 ( DbConnectionStringBuilder から継承されます。) |
![]() | ConnectionString | DbConnectionStringBuilder に関連付けられる接続文字列を取得または設定します。 ( DbConnectionStringBuilder から継承されます。) |
![]() | Count | ConnectionString プロパティに格納されている、現在のキー数を取得します。 ( DbConnectionStringBuilder から継承されます。) |
![]() | DataSource | 接続先の Oracle データ ソースの名前を取得または設定します。 |
![]() | Enlist | プーラーが、作成スレッドの現在のトランザクション コンテキストに、接続を自動的に登録するかどうかを示す値を取得または設定します。 |
![]() | IntegratedSecurity | "User ID" および "Password" を接続文字列中に指定するか (false の場合)、現在の Windows アカウントの資格情報を認証に使用するか (true の場合) を示す値を取得または設定します。 |
![]() | IsFixedSize | オーバーライドされます。 OracleConnectionStringBuilder が固定サイズかどうかを示す値を取得します。 |
![]() | IsReadOnly | DbConnectionStringBuilder が読み取り専用かどうかを示す値を取得します。 ( DbConnectionStringBuilder から継承されます。) |
![]() | Item | オーバーライドされます。 指定したキーに関連付けられている値を取得または設定します。C# では、このプロパティはインデクサです。 |
![]() | Keys | オーバーライドされます。 OracleConnectionStringBuilder 内のキーを格納している ICollection を取得します。 |
![]() | LoadBalanceTimeout | 接続プールに維持されている接続が削除されるまでの最短時間 (秒) を取得または設定します。 |
![]() | MaxPoolSize | 特定の接続文字列について、接続プールに維持できる最大接続数を取得または設定します。 |
![]() | MinPoolSize | 特定の接続文字列について、接続プールに維持できる最小接続数を取得または設定します。 |
![]() | OmitOracleConnectionName | 旧バージョンの Oracle (8.1.7.4.1 以前) でトランザクションのロールバックを可能にするフラグを取得または設定します。 |
![]() | Password | Oracle アカウントに使用するパスワードを取得または設定します。 |
![]() | PersistSecurityInfo | 接続が開いているか、開いている状態になったことがある場合に、パスワードなどの機密性の高い情報を接続文字列の一部として返すかどうかを示すブール値を取得または設定します。 |
![]() | Pooling | 接続をプールするか、要求ごとに明示的に各接続を確立するかを示すブール値を取得または設定します。 |
![]() | Unicode | 最近の Oracle クライアントで利用できる Unicode 機能をクライアントがサポートしているか、または Unicode 非対応かを示すブール値を取得または設定します。 |
![]() | UserID | Oracle との接続時に使用するユーザー ID を取得または設定します。 |
![]() | Values | オーバーライドされます。 OracleConnectionStringBuilder 内の値を格納している ICollection を取得します。 |

関連項目
OracleConnectionStringBuilder クラスSystem.Data.OracleClient 名前空間
その他の技術情報
Building Connection StringsOracleConnectionStringBuilder メソッド

名前 | 説明 | |
---|---|---|
![]() | Add | 指定したキーおよび値を持つエントリを DbConnectionStringBuilder に追加します。 ( DbConnectionStringBuilder から継承されます。) |
![]() | AppendKeyValuePair | オーバーロードされます。 効率的かつ安全に、既存の StringBuilder オブジェクトにキーと値を追加できます。 ( DbConnectionStringBuilder から継承されます。) |
![]() | Clear | オーバーライドされます。 OracleConnectionStringBuilder インスタンスの内容を消去します。 |
![]() | ContainsKey | オーバーライドされます。 OracleConnectionStringBuilder に特定のキーが格納されているかどうかを判断します。 |
![]() | Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。) |
![]() | EquivalentTo | この DbConnectionStringBuilder オブジェクト内の接続情報と、指定したオブジェクト内の接続情報を比較します。 ( DbConnectionStringBuilder から継承されます。) |
![]() | GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。) |
![]() | GetType | 現在のインスタンスの Type を取得します。 ( Object から継承されます。) |
![]() | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。) |
![]() | Remove | オーバーライドされます。 指定したキーを持つエントリを OracleConnectionStringBuilder インスタンスから削除します。 |
![]() | ShouldSerialize | オーバーライドされます。 指定されたキーが、この OracleConnectionStringBuilder インスタンスに存在するかどうかを示します。 |
![]() | ToString | この DbConnectionStringBuilder に関連付けられている接続文字列を返します。 ( DbConnectionStringBuilder から継承されます。) |
![]() | TryGetValue | オーバーライドされます。 指定されたキーに対応する値を OracleConnectionStringBuilder から取得します。 |

名前 | 説明 | |
---|---|---|
![]() | ClearPropertyDescriptors | 関連付けられている DbConnectionStringBuilder で、PropertyDescriptor オブジェクトのコレクションを削除します。 ( DbConnectionStringBuilder から継承されます。) |
![]() | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。) |
![]() | GetProperties | 指定した HashTable に、この DbConnectionStringBuilder のすべてのプロパティに関する情報を格納します。 ( DbConnectionStringBuilder から継承されます。) |
![]() | MemberwiseClone | 現在の Object の簡易コピーを作成します。 ( Object から継承されます。) |

関連項目
OracleConnectionStringBuilder クラスSystem.Data.OracleClient 名前空間
その他の技術情報
Building Connection StringsOracleConnectionStringBuilder メンバ
OracleConnection クラスで使用する接続文字列の内容の作成と管理を簡単に実行できるようにします。
OracleConnectionStringBuilder データ型で公開されるメンバを以下の表に示します。

名前 | 説明 | |
---|---|---|
![]() | OracleConnectionStringBuilder | オーバーロードされます。 OracleConnectionStringBuilder クラスの新しいインスタンスを初期化します。 |

名前 | 説明 | |
---|---|---|
![]() | BrowsableConnectionString | ConnectionString プロパティが Visual Studio デザイナに表示できるかどうかを指定する値を取得または設定します。(DbConnectionStringBuilder から継承されます。) |
![]() | ConnectionString | DbConnectionStringBuilder に関連付けられる接続文字列を取得または設定します。(DbConnectionStringBuilder から継承されます。) |
![]() | Count | ConnectionString プロパティに格納されている、現在のキー数を取得します。(DbConnectionStringBuilder から継承されます。) |
![]() | DataSource | 接続先の Oracle データ ソースの名前を取得または設定します。 |
![]() | Enlist | プーラーが、作成スレッドの現在のトランザクション コンテキストに、接続を自動的に登録するかどうかを示す値を取得または設定します。 |
![]() | IntegratedSecurity | "User ID" および "Password" を接続文字列中に指定するか (false の場合)、現在の Windows アカウントの資格情報を認証に使用するか (true の場合) を示す値を取得または設定します。 |
![]() | IsFixedSize | オーバーライドされます。 OracleConnectionStringBuilder が固定サイズかどうかを示す値を取得します。 |
![]() | IsReadOnly | DbConnectionStringBuilder が読み取り専用かどうかを示す値を取得します。(DbConnectionStringBuilder から継承されます。) |
![]() | Item | オーバーライドされます。 指定したキーに関連付けられている値を取得または設定します。C# では、このプロパティはインデクサです。 |
![]() | Keys | オーバーライドされます。 OracleConnectionStringBuilder 内のキーを格納している ICollection を取得します。 |
![]() | LoadBalanceTimeout | 接続プールに維持されている接続が削除されるまでの最短時間 (秒) を取得または設定します。 |
![]() | MaxPoolSize | 特定の接続文字列について、接続プールに維持できる最大接続数を取得または設定します。 |
![]() | MinPoolSize | 特定の接続文字列について、接続プールに維持できる最小接続数を取得または設定します。 |
![]() | OmitOracleConnectionName | 旧バージョンの Oracle (8.1.7.4.1 以前) でトランザクションのロールバックを可能にするフラグを取得または設定します。 |
![]() | Password | Oracle アカウントに使用するパスワードを取得または設定します。 |
![]() | PersistSecurityInfo | 接続が開いているか、開いている状態になったことがある場合に、パスワードなどの機密性の高い情報を接続文字列の一部として返すかどうかを示すブール値を取得または設定します。 |
![]() | Pooling | 接続をプールするか、要求ごとに明示的に各接続を確立するかを示すブール値を取得または設定します。 |
![]() | Unicode | 最近の Oracle クライアントで利用できる Unicode 機能をクライアントがサポートしているか、または Unicode 非対応かを示すブール値を取得または設定します。 |
![]() | UserID | Oracle との接続時に使用するユーザー ID を取得または設定します。 |
![]() | Values | オーバーライドされます。 OracleConnectionStringBuilder 内の値を格納している ICollection を取得します。 |

名前 | 説明 | |
---|---|---|
![]() | Add | 指定したキーおよび値を持つエントリを DbConnectionStringBuilder に追加します。 (DbConnectionStringBuilder から継承されます。) |
![]() | AppendKeyValuePair | オーバーロードされます。 効率的かつ安全に、既存の StringBuilder オブジェクトにキーと値を追加できます。 (DbConnectionStringBuilder から継承されます。) |
![]() | Clear | オーバーライドされます。 OracleConnectionStringBuilder インスタンスの内容を消去します。 |
![]() | ContainsKey | オーバーライドされます。 OracleConnectionStringBuilder に特定のキーが格納されているかどうかを判断します。 |
![]() | Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。) |
![]() | EquivalentTo | この DbConnectionStringBuilder オブジェクト内の接続情報と、指定したオブジェクト内の接続情報を比較します。 (DbConnectionStringBuilder から継承されます。) |
![]() | GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。) |
![]() | GetType | 現在のインスタンスの Type を取得します。 (Object から継承されます。) |
![]() | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。) |
![]() | Remove | オーバーライドされます。 指定したキーを持つエントリを OracleConnectionStringBuilder インスタンスから削除します。 |
![]() | ShouldSerialize | オーバーライドされます。 指定されたキーが、この OracleConnectionStringBuilder インスタンスに存在するかどうかを示します。 |
![]() | ToString | この DbConnectionStringBuilder に関連付けられている接続文字列を返します。 (DbConnectionStringBuilder から継承されます。) |
![]() | TryGetValue | オーバーライドされます。 指定されたキーに対応する値を OracleConnectionStringBuilder から取得します。 |

名前 | 説明 | |
---|---|---|
![]() | ClearPropertyDescriptors | 関連付けられている DbConnectionStringBuilder で、PropertyDescriptor オブジェクトのコレクションを削除します。 (DbConnectionStringBuilder から継承されます。) |
![]() | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。) |
![]() | GetProperties | 指定した HashTable に、この DbConnectionStringBuilder のすべてのプロパティに関する情報を格納します。 (DbConnectionStringBuilder から継承されます。) |
![]() | MemberwiseClone | 現在の Object の簡易コピーを作成します。 (Object から継承されます。) |

関連項目
OracleConnectionStringBuilder クラスSystem.Data.OracleClient 名前空間
その他の技術情報
Building Connection StringsWeblioに収録されているすべての辞書からOracleConnectionStringBuilderを検索する場合は、下記のリンクをクリックしてください。

- OracleConnectionStringBuilderのページへのリンク