DbConnectionStringBuilder.Add(String, Object) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Добавляет запись с указанными ключом и значением в DbConnectionStringBuilder.
public:
void Add(System::String ^ keyword, System::Object ^ value);public void Add (string keyword, object value);member this.Add : string * obj -> unitPublic Sub Add (keyword As String, value As Object)Параметры
- keyword
- String
Ключ, добавляемый в DbConnectionStringBuilder.
- value
- Object
Значение заданного ключа.
Исключения
Параметр keyword является неопределенной ссылкой (Nothing в Visual Basic).
Объект 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 Вызов метода путем передачи ключа NULL (Nothing в Visual Basic) вызывает исключение ArgumentNullException. Однако вызов Add метода путем передачи значения NULL удаляет пару "ключ-значение".
