DbConnectionStringBuilder.Add(String, Object) Método

Definição

Namespace:

System.Data.Common

Assembly:

System.Data.Common.dll

Origem:

DbConnectionStringBuilder.cs

Adiciona uma entrada com a chave e o valor especificados ao 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)

Parâmetros

keyword

String

A chave a adicionar à DbConnectionStringBuilder.

value

Object

O valor para a chave especificada.

Exceções

ArgumentNullException

keyword é uma referência nula (Nothing no Visual Basic).

NotSupportedException

O DbConnectionStringBuilder é somente leitura.

- ou -

O DbConnectionStringBuilder tem um tamanho fixo.

Exemplos

O exemplo a seguir cria um novo DbConnectionStringBuilder e adiciona itens. O código também demonstra a substituição de um item existente usando o Add método e inclui um bloco com comentários que geraria um ArgumentNullException.

Observação

Este exemplo inclui uma senha para demonstrar como DbConnectionStringBuilder funciona com cadeias de conexão. Em seus aplicativos, recomendamos que você use a Autenticação do Windows. Se você precisar usar uma senha, não inclua uma senha embutida em código em seu aplicativo.

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

Comentários

A Item[] propriedade também pode ser usada para adicionar novos elementos definindo o valor de uma chave que não existe no dicionário. Por exemplo: myCollection["myNonexistentKey"] = myValue.

Chamar o Add método passando uma chave nula (Nothing no Visual Basic) lança um ArgumentNullException. No entanto, chamar o Add método passando um valor nulo remove o par chave/valor.

Confira também

• Cadeias de conexão no ADO.NET
• Visão geral do ADO.NET