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

こちらもご覧ください

• 接続文字列の作成