DbConnectionStringBuilder.ConnectionString Propiedad

Definición

Espacio de nombres:

System.Data.Common

Ensamblado:

System.Data.Common.dll

Source:

DbConnectionStringBuilder.cs

Obtiene o establece la cadena de conexión asociada con el DbConnectionStringBuilder.

public:
 property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };

public string ConnectionString { get; set; }

member this.ConnectionString : string with get, set

Public Property ConnectionString As String

Valor de propiedad

String

La cadena de conexión actual, creada a partir de los pares clave/valor que están dentro del DbConnectionStringBuilder. El valor predeterminado es una cadena vacía.

Excepciones

ArgumentException

Se ha proporcionado un argumento de cadena de conexión no válido.

Ejemplos

En el ejemplo siguiente se muestran posibles comportamientos de la ConnectionString propiedad . El ejemplo:

• Crea un cadena de conexión agregando pares clave-valor, de uno en uno, a un vacíoDbConnectionStringBuilder.

• Asigna una cadena de conexión completa a la ConnectionString propiedad de la DbConnectionStringBuilder instancia y modifica un único par clave-valor dentro de la cadena.

• Asigna un conjunto arbitrario de pares clave-valor a la ConnectionString propiedad (es decir, una cadena que no es nada de forma remota como un cadena de conexión) y modifica uno de los valores.

• Asigna un cadena de conexión no válido a la ConnectionString propiedad , que muestra la excepción que se produce.

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()
{
    // Create a new DbConnctionStringBuilder, and add items
    // to the internal collection of key/value pairs.
    DbConnectionStringBuilder builder = new
        DbConnectionStringBuilder();
    builder.Add("Data Source", @"c:\MyData\MyDb.mdb");
    builder.Add("Provider", "Microsoft.Jet.Oledb.4.0");
    builder.Add("Jet OLEDB:Database Password", "********");
    builder.Add("Jet OLEDB:System Database",
        @"c:\MyData\Workgroup.mdb");

    // Set up row-level locking.
    builder.Add("Jet OLEDB:Database Locking Mode", 1);
    // Display the contents of the connection string, which
    // will now contain all the key/value pairs delimited with
    // semicolons.
    Console.WriteLine(builder.ConnectionString);
    Console.WriteLine();
    // Clear the DbConnectionStringBuilder, and assign a complete
    // connection string to it, to demonstrate how
    // the class parses connection strings.
    builder.Clear();
    builder.ConnectionString =
        "Data Source=(local);Initial Catalog=AdventureWorks;"
        + "Integrated Security=SSPI";
    // The DbConnectionStringBuilder class has parsed the contents,
    // so you can work with any individual key/value pair.
    builder["Data Source"] = ".";
    Console.WriteLine(builder.ConnectionString);
    Console.WriteLine();
    // Because the DbConnectionStringBuilder class doesn't
    // validate its key/value pairs, you can use this class
    // to store any semicolon-delimited list. The following
    // snippet places an arbitrary string into the ConnectionString
    // property, changes one of the values, and then displays the
    // resulting string.
    builder.Clear();
    builder.ConnectionString =
        "Value1=10;Value2=20;Value3=30;Value4=40";
    builder["Value2"] = 25;
    Console.WriteLine(builder.ConnectionString);
    Console.WriteLine();

    builder.Clear();
    try
    {
        // Assigning an invalid connection string
        // throws an ArgumentException.
        builder.ConnectionString = "xxx";
    }
    catch (ArgumentException)
    {
        Console.WriteLine("Invalid connection string.");
    }

    Console.WriteLine();
    Console.WriteLine("Press Enter to finish.");
    Console.ReadLine();
}

Sub Main()
    ' Create a new DbConnctionStringBuilder, and add items
    ' to the internal collection of key/value pairs.
    Dim builder As New DbConnectionStringBuilder()
    builder.Add("Data Source", "c:\MyData\MyDb.mdb")
    builder.Add("Provider", "Microsoft.Jet.Oledb.4.0")
    builder.Add("Jet OLEDB:Database Password", "*******")
    builder.Add("Jet OLEDB:System Database", _
        "c:\MyData\Workgroup.mdb")
    ' Set up row-level locking.
    builder.Add("Jet OLEDB:Database Locking Mode", 1)

    ' Display the contents of the connection string, which
    ' will now contain all the key/value pairs delimited with
    ' semicolons.
    Console.WriteLine(builder.ConnectionString)
    Console.WriteLine()

    ' Clear the DbConnectionStringBuilder, and assign a complete
    ' connection string to it, to demonstrate how
    ' the class parses connection strings.
    builder.Clear()
    builder.ConnectionString = _
        "Data Source=(local);Initial Catalog=AdventureWorks;" & _
        "Integrated Security=SSPI"

    ' The DbConnectionStringBuilder class has parsed the contents, 
    ' so you can work with any individual key/value pair.
    builder("Data Source") = "."
    Console.WriteLine(builder.ConnectionString)
    Console.WriteLine()

    ' Because the DbConnectionStringBuilder class doesn't 
    ' validate its key/value pairs, you can use this class
    ' to store any semicolon-delimited list. The following
    ' snippet places an arbitrary string into the ConnectionString
    ' property, changes one of the values, and then displays the
    ' resulting string.
    builder.Clear()
    builder.ConnectionString = _
        "Value1=10;Value2=20;Value3=30;Value4=40"
    builder("Value2") = 25
    Console.WriteLine(builder.ConnectionString)
    Console.WriteLine()

    builder.Clear()
    Try
        ' Assigning an invalid connection string
        ' throws an ArgumentException.
        builder.ConnectionString = "xxx"

    Catch ex As ArgumentException
        Console.WriteLine("Invalid connection string.")
    End Try

    Console.WriteLine()
    Console.WriteLine("Press Enter to finish.")
    Console.ReadLine()
End Sub

Comentarios

Esta propiedad devuelve una lista delimitada por punto y coma de pares clave-valor almacenados dentro de la colección mantenida por .DbConnectionStringBuilder Cada par contiene la clave y el valor, separados por un signo igual. En el ejemplo siguiente se muestra un cadena de conexión típico.

"Persist Security Info=False;Integrated Security=SSPI;Initial Catalog=AdventureWorks;Data Source=(local)"

Los proveedores de datos pueden esperar claves y valores específicos para cada propiedad cadena de conexión. , estos valores se documentan individualmente. La DbConnectionStringBuilder clase no valida los pares clave-valor asociados a su cadena de conexión, aunque las clases que heredan de ella pueden.

La ConnectionString propiedad de la DbConnectionStringBuilder clase actúa generalmente como mecanismo para crear y analizar listas delimitadas por punto y coma de pares clave-valor separados con signos iguales. No proporciona ninguna validación u otra compatibilidad específica para las cadenas de conexión. Si agrega elementos a la DbConnectionStringBuilder colección, la ConnectionString propiedad reflejará los cambios. Si asigna un valor a la ConnectionString propiedad , DbConnectionStringBuilder intentará analizar el valor mediante los delimitadores de signo igual y punto y coma.

Consulte también

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