SqlConnectionStringBuilder Constructores

Definición

Espacio de nombres:

Microsoft.Data.SqlClient

Ensamblado:

Microsoft.Data.SqlClient.dll

Paquete:

Microsoft.Data.SqlClient v5.2.0

Sobrecargas

SqlConnectionStringBuilder()	Inicializa una nueva instancia de la clase SqlConnectionStringBuilder.
SqlConnectionStringBuilder(String)	Inicializa una nueva instancia de la clase SqlConnectionStringBuilder. La cadena de conexión proporcionada facilita los datos para la información de conexión interna de la instancia.

SqlConnectionStringBuilder()

Inicializa una nueva instancia de la clase SqlConnectionStringBuilder.

public:
 SqlConnectionStringBuilder();

public SqlConnectionStringBuilder ();

Public Sub New ()

SqlConnectionStringBuilder(String)

Inicializa una nueva instancia de la clase SqlConnectionStringBuilder. La cadena de conexión proporcionada facilita los datos para la información de conexión interna de la instancia.

public:
 SqlConnectionStringBuilder(System::String ^ connectionString);

public SqlConnectionStringBuilder (string connectionString);

new Microsoft.Data.SqlClient.SqlConnectionStringBuilder : string -> Microsoft.Data.SqlClient.SqlConnectionStringBuilder

Public Sub New (connectionString As String)

Parámetros

connectionString

String

Base para la información de conexión interna del objeto. Se analiza en pares de nombre/valor. Los nombres de clave no válidos provocan el evento KeyNotFoundException.

Excepciones

KeyNotFoundException

Nombre de clave no válido dentro de la cadena de conexión.

FormatException

Valor no válido dentro de la cadena de conexión (concretamente cuando se esperaba un valor booleano o numérico, pero no se ha proporcionado).

ArgumentException

La connectionString proporcionada no es válida.

Ejemplos

El ejemplo siguiente proporciona una conexión simple de SQL Server en el constructor SqlConnectionStringBuilder del objeto y, a continuación, recorre todos los pares clave-valor dentro del objeto. Tenga en cuenta que la colección proporciona valores predeterminados para cada elemento. Tenga en cuenta también que la clase SqlConnectionStringBuilder convierte sinónimos para las claves conocidas de manera que sean consistentes con los nombres conocidos.

Nota:

Este ejempo incluye una contraseña para demostrar cómo SqlConnectionStringBuilder 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.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        try
        {
            string connectString =
                "Server=(local);Database=AdventureWorks;UID=ab;Pwd= a!Pass@@";
            Console.WriteLine("Original: " + connectString);
            SqlConnectionStringBuilder builder =
                new SqlConnectionStringBuilder(connectString);
            Console.WriteLine("Modified: " + builder.ConnectionString);
            foreach (string key in builder.Keys)
                Console.WriteLine(key + "=" + builder[key].ToString());
            Console.WriteLine("Press any key to finish.");
            Console.ReadLine();

        }
        catch (System.Collections.Generic.KeyNotFoundException ex)
        {
            Console.WriteLine("KeyNotFoundException: " + ex.Message);
        }
        catch (System.FormatException ex)
        {
            Console.WriteLine("Format exception: " + ex.Message);
        }
    }
}

Comentarios

La clase SqlConnectionStringBuilder proporciona una colección interna de pares de clave-valor fija. Incluso si proporciona solo un pequeño subconjunto de los valores posibles de las cadenas de conexión en el constructor, el objeto siempre proporciona valores predeterminados para cada par de clave-valor. Cuando se recupera la ConnectionString propiedad del objeto, la cadena contiene solo pares clave-valor en los que el valor no es el valor predeterminado para el elemento.