SqlConnectionStringBuilder Constructores

Definición

Espacio de nombres:

System.Data.SqlClient

Ensamblado:

System.Data.dll

Inicializa una nueva instancia de la clase SqlConnectionStringBuilder.

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 ()

Consulte también

• Información general de ADO.NET

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 System.Data.SqlClient.SqlConnectionStringBuilder : string -> System.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 System.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);
        }
    }
}

Imports System.Data.SqlClient

Module Module1
    Sub Main()
        Try
            Dim connectString As String = _
                "Server=(local);Database=AdventureWorks;UID=ab;Pwd=a!Pass@@"
            Console.WriteLine("Original: " & connectString)
            Dim builder As New SqlConnectionStringBuilder(connectString)
            Console.WriteLine("Modified: " & builder.ConnectionString)
            For Each key As String In builder.Keys
                Console.WriteLine(key & "=" & builder.Item(key).ToString)
            Next
            Console.WriteLine("Press any key to finish.")
            Console.ReadLine()

        Catch ex As System.Collections.Generic.KeyNotFoundException
            Console.WriteLine("KeyNotFoundException: " & ex.Message)
        Catch ex As System.FormatException
            Console.WriteLine("Format exception: " & ex.Message)
        End Try
    End Sub
End Module

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.

Consulte también

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