OracleConnection.ConnectionString プロパティ

定義

名前空間:

System.Data.OracleClient

アセンブリ:

System.Data.OracleClient.dll

Oracle データベースを開くために使用する文字列を取得または設定します。

public:
 virtual property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.SettingsBindable(true)]
public override string ConnectionString { get; set; }

[<System.ComponentModel.SettingsBindable(true)>]
member this.ConnectionString : string with get, set

Public Overrides Property ConnectionString As String

プロパティ値

String

サーバー名など、初期接続を確立するために必要な設定を含んだ Oracle 接続文字列。 既定値は空の文字列 ("") です。

属性

SettingsBindableAttribute

例

次の例では、 をOracleConnection作成し、そのプロパティの一部を 接続文字列に設定します。

public void CreateOracleConnection()
{
    string connectionString = "Data Source=Oracle8i;Integrated Security=yes";
    using (OracleConnection connection = new OracleConnection(connectionString))
    {
        connection.Open();
        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)
        connection.Open()
        Console.WriteLine("ServerVersion: " + connection.ServerVersion _
           + ControlChars.NewLine + "DataSource: " + connection.DataSource)
    End Using
End Sub

注釈

は ConnectionString 、接続が閉じている場合にのみ設定できます。

プロパティを ConnectionString 使用してデータベースに接続できます。 次の例は、一般的な接続文字列を示しています。

"Data Source=Oracle8i;Integrated Security=yes"  

文字列で指定された設定の多くは、対応する読み取り専用プロパティ (たとえば、 Data Source=MyServerプロパティに DataSource 対応) を持っています。 接続文字列を設定すると、エラーが検出されない限り、これらのプロパティはすべて更新されます。その場合、どのプロパティも更新されません。 OracleConnection プロパティは、既定の設定または で ConnectionString指定された設定のみを返します。

閉じた接続で をConnectionStringリセットすると、パスワードを含むすべての接続文字列値 (および関連プロパティ) がリセットされます。

接続文字列は、設定された直後に解析されます。 構文の解析でエラーが表示される場合は、 などの ArgumentException実行時例外が生成されます。 その他のエラーは、接続を開こうとした場合にのみ見つかります。

接続文字列の基本形式は、セミコロンで区切られた一連のキーワード (keyword)/値ペアです。 それぞれのキーワードと値の関連付けには、等号 (=) が使用されます。 セミコロン、単一引用符、または二重引用符文字を含む値を含めるには、値を二重引用符で囲む必要があります。 値にセミコロンと二重引用符の両方が含まれている場合、値は単一引用符で囲むことができます。 単一引用符は、値が二重引用符で始まる場合にも役立ちます。 逆に、値が単一引用符で始まる場合は、二重引用符を使用できます。 値に単一引用符と二重引用符の両方が含まれている場合、値を囲むのに使用される引用符文字は、値内で発生するたびに 2 倍にする必要があります。

文字列値に前後のスペースを含めるには、値を単一引用符または二重引用符で囲む必要があります。 整数、ブール値、または列挙値の前後のスペースは、引用符で囲まれていても無視されます。 ただし、文字列リテラルキーワード (keyword)または値内のスペースは保持されます。 単一引用符または二重引用符は、値の最初または最後の文字である場合を除き、区切り記号を使用せずに接続文字列内で使用できます。たとえば、 Data Source= my'Server や Data Source= my"Serverなどです。

キーワード (keyword)または値に等号 (=) を含めるには、その前に別の等号を付ける必要があります。 たとえば、仮定の接続文字列

"key==word=value"  

キーワード (keyword)は "key=word" で、値は "value" です。

キーワード (keyword)/値ペア内の特定のキーワード (keyword)が接続文字列で複数回発生した場合は、値セットで最後の出現が使用されます。

キーワードでは大文字と小文字が区別されません。

次の表に、 内の値の有効な名前を ConnectionString示します。

名前	Default	説明
Data Source - または - サーバー		接続する Oracle のインスタンスの名前またはネットワーク アドレス。
Integrated Security	'false'	接続をセキュリティで保護された接続にするかどうか。 認識される値は true (強くお勧めします) false、、 yes、および noです。
Password		Oracle アカウントのログオン時のパスワード。 高レベルのセキュリティを維持するには、代わりに統合セキュリティ キーワード (keyword)を使用することを強くお勧めします。
Persist Security Info	'false'	または no にfalse設定すると (強くお勧めします)、接続が開いている場合や開いている場合、パスワードなどのセキュリティに依存するState情報は接続の一部として返されません。 接続文字列をリセットすると、パスワードを含むすべての接続文字列値がリセットされます。 認識される値は true、false、yes および no です。
Unicode	'false'	.NET Framework Data Provider for Oracle が UTF16 モードの API 呼び出しを使用するかどうかを指定します。 Oracle9i クライアント ソフトウェアを使用する場合を除き、このキーワード (keyword)は無視されます。
User ID		Oracle ログイン アカウント。 高レベルのセキュリティを維持するには、代わりに統合セキュリティ キーワード (keyword)を使用することを強くお勧めします。

次の表に、 内の接続プール値の有効な名前を ConnectionString示します。

名前	Default	説明
接続の有効期間	0	接続がプールに返された時点で、その接続の作成時刻と現在の時刻を比較し、その時間の長さ (秒) が Connection Lifetime で指定した値を超えている場合は、その接続が破棄されます。 これは、クラスター構成を採用している状況で、実行中のサーバーと、オンラインになったばかりのサーバーの間での、負荷を強制的に分散するのに便利です。 値が 0 の場合、プールされた接続の最大接続タイムアウトが発生します。
Enlist	'true'	または yesの場合true、プーラーは作成スレッドの現在のトランザクション コンテキストに接続を自動的に参加させます。 認識される値は true、false、yes および no です。
Max Pool Size	100	プールに格納できる最大接続数。 の値を Max Pool Size 設定すると、パフォーマンスに影響する ConnectionString 可能性があります。 100 を超える接続を作成してアクティブに使用する予定の場合は、アプリケーションの安定した状態の接続の使用量を概算する値に増やす Max Pool Size 必要があります。
Min Pool Size	0	プールで許可される接続の最小数。
Pooling	'true'	または yesの場合true、OracleConnectionオブジェクトは適切なプールから描画されるか、必要に応じて作成され、適切なプールに追加されます。 認識される値は true、false、yes および no です。

ブール値を必要とするキーワード (keyword)または接続プールの値を設定する場合は、'true' ではなく 'yes' を使用し、'false' の代わりに 'no' を使用できます。 整数値は文字列として表されます。