DbConnectionStringBuilder.Add(String, Object) Método

Definición

Espacio de nombres:

System.Data.Common

Ensamblado:

System.Data.Common.dll

Source:

DbConnectionStringBuilder.cs

Agrega una entrada con la clave y el valor especificados a 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

Clave que se va a agregar a DbConnectionStringBuilder.

value

Object

Valor para la clave especificada.

Excepciones

ArgumentNullException

keyword es una referencia nula (Nothing en Visual Basic).

NotSupportedException

DbConnectionStringBuilder es de solo lectura.

o bien

DbConnectionStringBuilder tiene un tamaño fijo.

Ejemplos

En el ejemplo siguiente se crea un elemento DbConnectionStringBuilder y se agregan elementos. El código también muestra la sobrescritura de un elemento existente mediante el Add método e incluye un bloque comentado que produciría un ArgumentNullException.

Nota

Este ejempo incluye una contraseña para demostrar cómo DbConnectionStringBuilder funciona con cadenas de conexión. Se recomienda que utilice autenticación de Windows en sus aplicaciones. Si necesita utilizar una contraseña en su aplicación, no incluya una contraseña codificada de forma rígida.

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

Comentarios

La Item[] propiedad también se puede usar para agregar nuevos elementos estableciendo el valor de una clave que no existe en el diccionario. Por ejemplo: myCollection["myNonexistentKey"] = myValue.

Al llamar al Add método pasando una clave null (Nothing en Visual Basic) se produce una ArgumentNullExceptionexcepción . Sin embargo, al llamar al Add método, al pasar un valor NULL, se quita el par clave-valor.

Consulte también

• Cadenas de conexión de ADO.NET
• Información general de ADO.NET