DbConnectionStringBuilder.Item[String] 屬性

定義

命名空間:
System.Data.Common
組件:
System.Data.Common.dll
組件:
System.Data.dll
組件:
netstandard.dll

取得或設定與指定鍵相關聯的值。

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

參數

keyword
String

要取得或設定的物品鑰匙。

屬性值

Object

與指定鍵相關聯的值。 如果找不到指定的鍵，嘗試取得它會拋出 ， ArgumentException而嘗試設定時會用指定的鍵建立一個新元素。

傳遞空鍵（Nothing in Visual Basic）會拋出 ArgumentNullException。 指派空值會移除鍵值對。

屬性
BrowsableAttribute

例外狀況

ArgumentException

集合中尚未設定 的 keyword 值。

ArgumentNullException

是一個空參考（）。

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

備註

當你設定此屬性時，若指定的金鑰已存在於字典中，該值會被替換;否則，會產生新的元素。

適用於

另請參閱