DbConnectionStringBuilder.Add(String, Object) 方法

  • 參考

定義

命名空間:
System.Data.Common
組件:
System.Data.Common.dll
組件:
System.Data.dll
組件:
netstandard.dll
來源:
DbConnectionStringBuilder.cs
來源:
DbConnectionStringBuilder.cs
來源:
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 為 null 參考 (在 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 方法會移除索引鍵/值組。

適用於

另請參閱