SqlConnectionStringBuilder.Item[String] 属性

定义

命名空间:

System.Data.SqlClient

程序集:

System.Data.dll

获取或设置与指定的键关联的值。 在 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[] 属性将键/值对添加到其连接字符串中。

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();
    }
}

Module Module1
    Sub Main()
        Dim builder As New SqlConnectionStringBuilder
        builder.Item("Data Source") = "(local)"
        ' Item is the default property, so 
        ' you needn't include it in the reference.
        builder("Integrated Security") = True
        builder.Item("Initial Catalog") = "AdventureWorks"

        ' Overwrite the existing value for the Data Source value.
        builder.Item("Data Source") = "."

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

注解

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

另请参阅

• ADO.NET 中的连接字符串
• ADO.NET 概述