SqlConnectionStringBuilder.Item[String] 属性

定义

命名空间:

Microsoft.Data.SqlClient

程序集:

Microsoft.Data.SqlClient.dll

包:

Microsoft.Data.SqlClient v5.2.0

获取或设置与指定的键关联的值。 在 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 为空引用（在 Visual Basic 中为 Nothing）。

KeyNotFoundException

尝试添加的键不存在于可用键内。

FormatException

连接字符串中包含无效的值（具体而言，需要使用布尔值或数值，但字符串中并未提供）。

示例

以下代码在控制台应用程序中新建一个 SqlConnectionStringBuilder，并使用 Item[] 属性将键/值对添加到其连接字符串中。

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        SqlConnectionStringBuilder builder =
            new SqlConnectionStringBuilder();
        builder["Data Source"] = "(local)";
        builder["Integrated Security"] = true;
        builder["Initial Catalog"] = "AdventureWorks";

        // Overwrite the existing value for the Data Source value.
        builder["Data Source"] = ".";

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

注解

由于 SqlConnectionStringBuilder 包含固定大小的字典，因此如果尝试添加的键不在字典中，则会引发 KeyNotFoundException。