DbConnectionStringBuilder.Add(String, Object) 方法

定义

命名空间:

System.Data.Common

程序集:

System.Data.Common.dll

Source:

DbConnectionStringBuilder.cs

将带有指定键和值的条目添加到 DbConnectionStringBuilder 中。

public:
 void Add(System::String ^ keyword, System::Object ^ value);

public void Add (string keyword, object value);

member this.Add : string * obj -> unit

Public Sub Add (keyword As String, value As Object)

参数

keyword

String

要添加到 DbConnectionStringBuilder 的键。

value

Object

指定键的值。

例外

ArgumentNullException

keyword 为空引用（在 Visual Basic 中为 Nothing）。

NotSupportedException

DbConnectionStringBuilder 为只读。

- 或 -

DbConnectionStringBuilder 具有固定的大小。

示例

以下示例创建新的 DbConnectionStringBuilder 并添加项。 该代码还演示了如何使用 Add 方法覆盖现有项，并包含将引发 的 ArgumentNullException注释块。

注意

该示例包括一个密码以演示 DbConnectionStringBuilder 如何使用连接字符串。 在您的应用程序中，建议使用 Windows 身份验证。 如果必须使用密码，请不要在你的应用程序中包括硬编码的密码。

static void Main()
{
    try
    {
        DbConnectionStringBuilder builder =
            new DbConnectionStringBuilder();
        builder.Add("Data Source", "ServerName");
        builder.Add("Initial Catalog", "TheDatabase");
        builder.Add("User ID", "UserName");
        builder.Add("Password", "*******");
        builder.Add("Command Logging", false);

        // Overwrite the existing "User ID" value.
        builder.Add("User ID", "NewUserName");

        // The following code would trigger
        // an ArgumentNullException:
        // builder.Add(null, "Some Value");

        Console.WriteLine(builder.ConnectionString);
    }
    catch (ArgumentNullException)
    {
        Console.WriteLine("Null key values are not allowed.");
    }

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

Sub Main()
    Try
        Dim builder As New DbConnectionStringBuilder
        builder.Add("Data Source", "ServerName")
        builder.Add("Initial Catalog", "TheDatabase")
        builder.Add("User ID", "UserName")
        builder.Add("Password", "*******")
        builder.Add("Command Logging", False)

        ' Overwrite the existing "User ID" value.
        builder.Add("User ID", "NewUserName")

        ' The following code would trigger 
        ' an ArgumentNullException.
        ' builder.Add(Nothing, "Some Value")

        Console.WriteLine(builder.ConnectionString)

    Catch ex As ArgumentNullException
        Console.WriteLine("Null key values are not allowed.")
    End Try

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

注解

属性 Item[] 还可用于通过设置字典中不存在的键的值来添加新元素。 例如：myCollection["myNonexistentKey"] = myValue。

Add通过在 Visual Basic 中传递 null (Nothing) 键调用 方法会ArgumentNullException引发 。 但是，通过传递 null 值调用 Add 方法会删除键/值对。

另请参阅

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