OracleConnection.ConnectionString OracleConnection.ConnectionString OracleConnection.ConnectionString OracleConnection.ConnectionString Property


取得または設定する Oracle データベースを開くために使用する文字列。Gets or sets the string used to open an Oracle database.

 virtual property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };
public override string ConnectionString { get; set; }
member this.ConnectionString : string with get, set
Public Overrides Property ConnectionString As String


最初の接続を確立するために、サーバー名などの設定を含む Oracle 接続文字列が必要です。The Oracle connection string that includes settings, such as the server name, needed to establish the initial connection. 既定値は、空の文字列 ("") です。The default value is an empty string ("").

次の例では、作成、OracleConnectionおよび接続文字列の一部のプロパティを設定します。The following example creates an OracleConnection and sets some of its properties in the connection string.

public void CreateOracleConnection()
    string connectionString = "Data Source=Oracle8i;Integrated Security=yes";
    using (OracleConnection connection = new OracleConnection(connectionString))
        Console.WriteLine("ServerVersion: " + connection.ServerVersion
            + "\nDataSource: " + connection.DataSource);
Public Sub CreateOracleConnection()
    Dim connectionString As String = _
       "Data Source=Oracle8i;Integrated Security=yes"

    Using connection As New OracleConnection(connectionString)
        Console.WriteLine("ServerVersion: " + connection.ServerVersion _
           + ControlChars.NewLine + "DataSource: " + connection.DataSource)
    End Using
End Sub


ConnectionString接続が閉じられたときにのみ設定できます。The ConnectionString can be set only when the connection is closed.

使用することができます、ConnectionStringプロパティをデータベースに接続します。You can use the ConnectionString property to connect to a database. 次の例では、一般的な接続文字列を示します。The following example illustrates a typical connection string.

"Data Source=Oracle8i;Integrated Security=yes"  

対応する読み取り専用プロパティを持つ文字列で指定された設定の多く (たとえば、Data Source=MyServerに対応する、DataSourceプロパティ)。Many of the settings specified in the string have corresponding read-only properties (for example, Data Source=MyServer, which corresponds to the DataSource property). 接続文字列を設定すると、これらすべてのプロパティがいない限り、更新エラーが検出された場合、プロパティのいずれも更新されます。When the connection string is set, all of these properties are updated, unless an error is detected, in which case none of the properties are updated. OracleConnection プロパティは、既定の設定またはで指定されたこれらの設定のみを返す、ConnectionStringします。OracleConnection properties return only default settings or those settings specified in the ConnectionString.

リセット、ConnectionString閉じた接続に対して、すべての接続文字列の値 (と関連するプロパティ)、パスワードを含むをリセットします。Resetting the ConnectionString on a closed connection resets all connection string values (and related properties), including the password.

接続文字列が設定されている後すぐに解析されます。The connection string is parsed immediately after being set. 構文、実行時例外、エラーなどがわかった解析場合ArgumentExceptionが生成されます。If parsing reveals errors in syntax, a run-time exception, such as ArgumentException, is generated. 試行、接続を開く場合にのみ、その他のエラーを確認できます。Other errors can be found only when an attempt is made to open the connection.

接続文字列の基本形式は、一連のキーワード/値ペアのセミコロンで区切られたです。The basic format of a connection string is a series of keyword/value pairs separated by semicolons. それぞれのキーワードと値の関連付けには、等号 (=) が使用されます。The equal sign (=) connects each keyword and its value. セミコロン、単一引用符または二重引用符文字が含まれている値を含めるには、値を二重引用符で囲む必要があります。To include values that contain a semicolon, single-quote character, or double-quote character, the value must be enclosed in double quotes. セミコロンと二重引用符文字の両方が、値が含まれる場合、値は単一引用符で囲むことができます。If the value contains both a semicolon and a double-quote character, the value can be enclosed in single quotes. 単一引用符も値が二重引用符文字で始まる場合に役立ちます。The single quote is also useful if the value begins with a double-quote character. 逆に、値が単一引用符で開始する場合は、二重引用符を使用できます。Conversely, the double quote can be used if the value begins with a single quote. 値に単一引用符と二重引用符の両方の文字が含まれている場合、値を囲むために使用する引用符文字は値の中で発生するたび倍する必要があります。If the value contains both single-quote and double-quote characters, the quote character used to enclose the value must be doubled each time it occurs within the value.

直前または文字列値の末尾のスペースを含めるには、一重引用符または二重引用符のいずれかの値を囲む必要があります。To include preceding or trailing spaces in the string value, the value must be enclosed in either single quotes or double quotes. 引用符で囲まれている場合でも、整数、ブール値、列挙値の先頭または末尾の空白は無視されます。Any leading or trailing spaces around integer, Boolean, or enumerated values are ignored, even if enclosed in quotes. ただし、文字列リテラル キーワードまたは値内にスペースが保持されます。However, spaces within a string literal keyword or value are preserved. 一重または二重引用符は、引用符文字をなど、値の最初または最後の文字がない限り、区切り記号を使用せず、接続文字列内で使用可能性がありますData Source= my'ServerまたはData Source= my"Serverします。Single or double quotes may be used within a connection string without using delimiters unless a quote character is the first or last character in the value, for example, Data Source= my'Server or Data Source= my"Server.

キーワードまたは値を等号 (=) を含めるもう 1 つの等号 (=) を前する必要があります。To include an equal sign (=) in a keyword or value, it must be preceded by another equal sign. たとえば、仮想的な接続文字列でFor example, in the hypothetical connection string


キーワードは"キー = word"、値は"value"です。the keyword is "key=word" and the value is "value".

接続文字列のキーワード/値ペアの特定のキーワードが複数回発生した場合、最後に見つかった値のセットで使用されます。If a specific keyword in a keyword/value pair occurs more than once in a connection string, the last occurrence is used in the value set.

キーワードは、大文字と小文字を区別しません。Keywords are case insensitive.

次の表には、内の値の有効な名前が一覧表示、ConnectionStringします。The following table lists the valid names for values within the ConnectionString.

名前Name 既定値Default 説明Description
データ ソースData Source

- または --or-

Oracle の接続先のインスタンスの名前またはネットワーク アドレス。The name or network address of the instance of Oracle to which to connect.
Integrated SecurityIntegrated Security 'false''false' 接続がセキュリティで保護された接続であるかどうかをかどうか。Whether the connection is to be a secure connection or not.

認識できる値はtrue(強く推奨)、 falseyes、およびnoします。Recognized values are true (strongly recommended), false, yes, and no.
[Password]Password ログオン Oracle アカウントのパスワード。The password for the Oracle account logging on. 高レベルのセキュリティを維持するために強くお勧め、統合セキュリティ キーワードを使用することです。To maintain a high level of security, we strongly recommend that you use the Integrated Security keyword instead.
Persist Security InfoPersist Security Info 'false''false' 設定するとfalseまたはno(強く推奨)、接続が開いているか、開いているになった場合、接続文字列の一部として、パスワードなどの機密情報が返されませんStateします。When set to false or no (strongly recommended), security-sensitive information such as the password is not returned as part of the connection if the connection is open or has ever been in an open State. 接続文字列をリセットするパスワードを含むすべての接続文字列の値をリセットします。Resetting the connection string resets all connection string values, including the password.

認識される値は truefalseyes および no です。Recognized values are true, false, yes, and no.
UnicodeUnicode 'false''false' .NET Framework Data Provider for Oracle が UTF16 モードの API 呼び出しを使用するかどうかを指定します。Specifies whether the .NET Framework Data Provider for Oracle uses UTF16 mode API calls. このキーワードは Oracle9i クライアント ソフトウェアを使用する場合を除き無視されます。This keyword is ignored except when using Oracle9i client software.
User IDUser ID Oracle ログイン アカウントです。The Oracle login account. 高レベルのセキュリティを維持するために強くお勧め、統合セキュリティ キーワードを使用することです。To maintain a high level of security, we strongly recommend that you use the Integrated Security keyword instead.

次の表には、接続プール内の値の有効な名前が一覧表示、ConnectionStringします。The following table lists the valid names for connection pooling values within the ConnectionString.

名前Name 既定値Default 説明Description
接続の有効期間Connection Lifetime 00 接続がプールに返された時点で、その接続の作成時刻と現在の時刻を比較し、その時間の長さ (秒) が Connection Lifetime で指定した値を超えている場合は、その接続が破棄されます。When a connection is returned to the pool, its creation time is compared with the current time, and the connection is destroyed if that time span (in seconds) exceeds the value specified by Connection Lifetime. これは、クラスター構成を採用している状況で、実行中のサーバーと、オンラインになったばかりのサーバーの間での、負荷を強制的に分散するのに便利です。This is useful in clustered configurations to force load balancing between a running server and a server just brought online.

値 0 の場合、プールされた接続の最大接続タイムアウトにします。A value of zero causes pooled connections to have the maximum connection time-out.
EnlistEnlist 'true''true' ときにtrueまたはyes、プーラーが、作成スレッドの現在のトランザクション コンテキストで接続を自動的に登録します。When true or yes, the pooler automatically enlists the connection in the creation thread's current transaction context.

認識される値は truefalseyes および no です。Recognized values are true, false, yes, and no.
Max Pool SizeMax Pool Size 100100 プールに格納できる最大接続数。The maximum number of connections allowed in the pool. 設定、Max Pool Sizeの値、ConnectionStringパフォーマンスに影響を与えることができます。Setting the Max Pool Size value of the ConnectionString can affect performance. 作成して積極的に 100 個の接続では複数使用する必要がありますを増やす場合Max Pool Sizeアプリケーションの安定した状態の接続の使用量の概算値にします。If you plan to create and actively use more than 100 connections, you should increase Max Pool Size to a value that approximates the steady-state connection usage for the application.
Min Pool SizeMin Pool Size 00 プールで許可される接続の最小数。The minimum number of connections allowed in the pool.
PoolingPooling 'true''true' ときにtrueまたはyesOracleConnectionオブジェクトが適切なプールから描画または必要に応じてが作成され、適切なプールに追加します。When true or yes, the OracleConnection object is drawn from the appropriate pool, or if necessary, is created and added to the appropriate pool.

認識される値は truefalseyes および no です。Recognized values are true, false, yes, and no.

キーワードまたは接続プールをブール値を必要とする値を設定する場合は、'true' ではなくと 'no' に 'false' ではなく 'yes' を使用できます。When setting keyword or connection pooling values that require a Boolean value, you can use 'yes' instead of 'true', and 'no' instead of 'false'. 整数値は文字列として表されます。Integer values are represented as strings.