DbConnectionStringBuilder.Item[String] プロパティ

定義

名前空間:

System.Data.Common

アセンブリ:

System.Data.Common.dll

ソース:

DbConnectionStringBuilder.cs

指定されたキーに関連付けられている値を取得または設定します。

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

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

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

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

パラメーター

keyword

String

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

プロパティ値

Object

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

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

属性

BrowsableAttribute

例外

ArgumentNullException

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

NotSupportedException

このプロパティが設定されていますが、DbConnectionStringBuilder が読み取り専用です。

- または -

プロパティが設定済みで、コレクション内に keyword が存在せず、DbConnectionStringBuilder が固定サイズです。

例

次のコンソール アプリケーションでは、 プロパティを使用して、新しい 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 の概要