OracleConnectionStringBuilder.Item[String] プロパティ

  • リファレンス

定義

名前空間:
System.Data.OracleClient
アセンブリ:
System.Data.OracleClient.dll

指定されたキーに関連付けられている値を取得または設定します。 C# の場合、このプロパティはインデクサーです。

public:
 virtual property System::Object ^ default[System::String ^] { System::Object ^ get(System::String ^ keyword); void set(System::String ^ keyword, System::Object ^ value); };
public override object this[string keyword] { get; set; }
member this.Item(string) : obj with get, set
Default Public Overrides Property Item(keyword As String) As Object

パラメーター

keyword
String

取得または設定する項目のキー。

プロパティ値

Object

指定されたキーに関連付けられている値。

例外

ArgumentNullException

keyword が null 参照 (Visual Basic の場合は Nothing) です。

KeyNotFoundException

利用できるキー内に存在しないキーを追加しようとしました。

FormatException

接続文字列に無効な値が含まれています (具体的には、ブール値または数値が要求されているにもかかわらず適切な値が提供されませんでした)。

例

コンソール アプリケーションに含まれる次のコードでは、新しい OracleConnectionStringBuilder を作成し、Item[] プロパティを使用して、接続文字列にキー/値ペアを追加します。

// 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()
    {
        OracleConnectionStringBuilder builder =
            new OracleConnectionStringBuilder();
        builder["Data Source"] = "localhost";
        builder["integrated security"] = true;
        builder["Unicode"] = true;

        // Overwrite the existing value for the Data Source value.
        builder["Data Source"] = "NewOracleDemo";

        Console.WriteLine(builder.ConnectionString);
        Console.WriteLine();
        Console.WriteLine("Press Enter to continue.");
        Console.ReadLine();
    }
}

' You may need to set a reference to the System.Data.OracleClient
' assembly before you can run this sample.
Imports System.Data.OracleClient

Module Module1
  Sub Main()
    Dim builder As New OracleConnectionStringBuilder
    builder.Item("Data Source") = "OracleDemo"
    ' Item is the default property, so 
    ' you need not include it in the reference.
    builder("integrated security") = True
    builder.Item("Unicode") = True

    ' Overwrite the existing value for the Data Source value.
    builder.Item("Data Source") = "NewOracleDemo"

    Console.WriteLine(builder.ConnectionString)
    Console.WriteLine()
    Console.WriteLine("Press Enter to continue.")
    Console.ReadLine()
  End Sub
End Module

注釈

OracleConnectionStringBuilder には固定サイズのディクショナリが含まれているので、ディクショナリに存在しないキーを追加しようとすると KeyNotFoundException がスローされます。 次の表に、接続文字列内で使用可能なすべてのキーと、それぞれの既定値を示します。

Key プロパティ 既定値
データ ソース (またはサーバー) DataSource 空の文字列
セキュリティ情報の永続化 (または persistsecurityinfo) PersistSecurityInfo ×
Integrated Security IntegratedSecurity ×
ユーザー ID (またはユーザーまたは uid) UserID 空の文字列
Password Password 空の文字列
Enlist Enlist ○
Pooling Pooling ○
Min Pool Size MinPoolSize 0
Max Pool Size MaxPoolSize 100
Oracle 接続名を省略する OmitOracleConnectionName ×
Unicode Unicode ×
負荷分散タイムアウト (または接続の有効期間) LoadBalanceTimeout 0

適用対象

こちらもご覧ください