OracleConnectionStringBuilder OracleConnectionStringBuilder OracleConnectionStringBuilder OracleConnectionStringBuilder Constructors

定義

オーバーロード

OracleConnectionStringBuilder() OracleConnectionStringBuilder() OracleConnectionStringBuilder()

OracleConnectionStringBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the OracleConnectionStringBuilder class.

OracleConnectionStringBuilder(String) OracleConnectionStringBuilder(String) OracleConnectionStringBuilder(String) OracleConnectionStringBuilder(String)

OracleConnectionStringBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the OracleConnectionStringBuilder class. 指定された接続文字列によって、インスタンスの内部的な接続情報のデータが提供されます。The provided connection string provides the data for the instance's internal connection information.

OracleConnectionStringBuilder() OracleConnectionStringBuilder() OracleConnectionStringBuilder()

OracleConnectionStringBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the OracleConnectionStringBuilder class.

public:
 OracleConnectionStringBuilder();
public OracleConnectionStringBuilder ();
Public Sub New ()
こちらもご覧ください

OracleConnectionStringBuilder(String) OracleConnectionStringBuilder(String) OracleConnectionStringBuilder(String) OracleConnectionStringBuilder(String)

OracleConnectionStringBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the OracleConnectionStringBuilder class. 指定された接続文字列によって、インスタンスの内部的な接続情報のデータが提供されます。The provided connection string provides the data for the instance's internal connection information.

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 String String String

オブジェクトの内部的な接続情報のベース。The basis for the object's internal connection information. この情報が解析され、名前/値のペアが生成されます。Parsed into name/value pairs. 無効なキー名を指定すると、KeyNotFoundException が発生します。Invalid key names raise a KeyNotFoundException.

例外

接続文字列内のキー名が無効です。Invalid key name within the connection string.

接続文字列に無効な値が含まれています (具体的には、ブール値または数値が要求されているにもかかわらず適切な値が提供されませんでした)。Invalid value within the connection string (specifically, when a Boolean or numeric value was expected but not supplied).

次の例で単純な接続文字列を提供する、OracleConnectionStringBuilderオブジェクトのコンス トラクター、およびオブジェクト内のすべてのキー/値ペアを反復処理します。The following example supplies a simple connection string in the OracleConnectionStringBuilder object's constructor, and then iterates through all the key/value pairs within the object. コレクションに各項目の既定値は、することに注意してください。Note that the collection provides default values for each items. また、OracleConnectionStringBuilder クラスでは、既知の名前と矛盾しないように、既知のキーに対するシノニムの変換も行われます。Also note that the OracleConnectionStringBuilder class converts synonyms for the well-known keys so that they are consistent with the well-known names.

注意

この例には、OracleConnectionStringBuilder による接続文字列の操作方法を示すために、パスワードが含まれています。This example includes a password to demonstrate how OracleConnectionStringBuilder works with connection strings. 実際のアプリケーションでは、Windows 認証を使用することをお勧めします。In your applications, we recommend that you use Windows Authentication. パスワードを使用する必要がある場合も、ハードコードされたパスワードをアプリケーションに含めないでください。If you must use a password, do not include a hard-coded password in your application.

// 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 クラスは、あらかじめ決められたキー/値ペアの内部コレクションを提供します。The OracleConnectionStringBuilder class provides a fixed internal collection of key/value pairs. 有効な接続文字列値のごく一部のみをコンストラクターに渡した場合も、このオブジェクトでは常に、キー/値の各ペアの既定値が提供されます。Even if you supply only a small subset of the possible connection string values in the constructor, the object always provides default values for each key/value pair. ときに、ConnectionStringオブジェクトのプロパティを取得、文字列には値は、項目の既定値から別のキー/値ペアのみが含まれています。When the ConnectionString property of the object is retrieved, the string contains only key/value pairs in which the value is different from the default value for the item.

こちらもご覧ください

適用対象