OracleConnectionStringBuilder.Item[String] OracleConnectionStringBuilder.Item[String] OracleConnectionStringBuilder.Item[String] OracleConnectionStringBuilder.Item[String] Property

定義

指定されたキーに関連付けられている値を取得または設定します。Gets or sets the value associated with the specified key. C# の場合、このプロパティはインデクサーです。In C#, this property is the indexer.

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

取得または設定する項目のキー。The key of the item to get or set.

プロパティ値

指定されたキーに関連付けられている値。The value associated with the specified key.

例外

keyword が null 参照 (Visual Basic の場合は Nothing) です。keyword is a null reference (Nothing in Visual Basic).

利用できるキー内に存在しないキーを追加しようとしました。Tried to add a key which does not exist within the available keys.

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

コンソール アプリケーションに含まれる次のコードでは、新しい OracleConnectionStringBuilder を作成し、Item[String] プロパティを使用して、接続文字列にキー/値ペアを追加します。The following code, in a console application, creates a new OracleConnectionStringBuilder and adds key/value pairs to its connection string, using the Item[String] property.

// 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 がスローされます。Because the OracleConnectionStringBuilder contains a fixed-size dictionary, trying to add a key that does not exist within the dictionary throws a KeyNotFoundException. 次の表では、それぞれ、接続文字列と既定値内のすべての可能なキーを一覧表示します。The following table lists all the possible keys within the connection string, and the default value for each.

キーKey プロパティProperty 既定値Default value
データ ソース (またはサーバー)Data Source (or server) DataSource 空の文字列Empty string
セキュリティ情報 (または persistsecurityinfo) を永続化します。Persist Security Info (or persistsecurityinfo) PersistSecurityInfo FalseFalse
Integrated SecurityIntegrated Security IntegratedSecurity FalseFalse
ユーザー ID (ユーザーまたは uid)User ID (or user or uid) UserID 空の文字列Empty string
パスワードPassword Password 空の文字列Empty string
EnlistEnlist Enlist TrueTrue
PoolingPooling Pooling TrueTrue
Min Pool SizeMin Pool Size MinPoolSize 00
Max Pool SizeMax Pool Size MaxPoolSize 100100
Oracle の接続名を省略します。Omit Oracle Connection Name OmitOracleConnectionName FalseFalse
UnicodeUnicode Unicode FalseFalse
Balance Timeout (または接続の有効期間) を読み込むLoad Balance Timeout (or connection lifetime) LoadBalanceTimeout 00

適用対象

こちらもご覧ください