DbConnectionStringBuilder.Item[String] プロパティ

public:
 virtual property System::Object ^ default[System::String ^] { System::Object ^ get(System::String ^ keyword); void set(System::String ^ keyword, System::Object ^ value); };

public virtual object this[string keyword] { get; set; }

[System.ComponentModel.Browsable(false)]
public virtual object this[string keyword] { get; set; }

member this.Item(string) : obj with get, set

[<System.ComponentModel.Browsable(false)>]
member this.Item(string) : obj with get, set

Default Public Overridable Property Item(keyword As String) As Object

パラメーター

プロパティ値

指定されたキーに関連付けられている値。 指定したキーが見つからない場合、そのキーを取得しようとした場合はnull 参照が返され (Visual Basic では Nothing)、そのキーを設定しようとした場合は、指定したキーを使用して新しい要素が作成されます。

null キー (Visual Basic では Nothing) を渡すと、ArgumentNullException がスローされます。 null 値を割り当てると、キー/値ペアが削除されます。

属性

BrowsableAttribute

例外

例

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

static void Main()
{
    DbConnectionStringBuilder builder = new
        DbConnectionStringBuilder();
    builder["Data Source"] = "(local)";

    // Note that Item is the indexer, so
    // you do not include it in the reference.
    builder["integrated security"] = true;
    builder["Initial Catalog"] = "AdventureWorks";

    // Overwrite the existing value for the Data Source key,
    // because it already exists within the collection.
    builder["Data Source"] = ".";

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

Module Module1

    Sub Main()
        Dim builder As New DbConnectionStringBuilder
        builder.Item("Data Source") = "(local)"

        ' Item is the default property, so 
        ' you need not include it in the reference.
        builder("integrated security") = True
        builder.Item("Initial Catalog") = "AdventureWorks"

        ' Overwrite the existing value for the data source value, 
        ' because it already exists within the collection.
        builder.Item("Data Source") = "."

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

注釈

このプロパティを設定すると、指定したキーがディクショナリに既に存在する場合は、値が置き換えられます。それ以外の場合は、新しい要素が作成されます。

適用対象

こちらもご覧ください

• ADO.NET での接続文字列
• ADO.NET の概要