DbConnectionStringBuilder.Add(String, Object) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將有指定索引鍵和數值項目加入 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
指定索引鍵的值。
例外狀況
keyword
為 null 參考 (在 Visual Basic 中為 Nothing
)。
範例
下列範例會建立新的 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 概觀 \(部分機器翻譯\)