SqlConnection Constructores

Definición

Espacio de nombres:

Microsoft.Data.SqlClient

Ensamblado:

Microsoft.Data.SqlClient.dll

Paquete:

Microsoft.Data.SqlClient v5.2.0

Sobrecargas

SqlConnection()	Inicializa una nueva instancia de la clase SqlConnection.
SqlConnection(String)	Inicializa una nueva instancia de la clase SqlConnection, dada una cadena que contiene la cadena de conexión.
SqlConnection(String, SqlCredential)	Inicializa una nueva instancia de la clase SqlConnection a la que se proporciona una cadena de conexión que no usa Integrated Security = true y un objeto SqlCredential que contiene el identificador de usuario y la contraseña.

SqlConnection()

Inicializa una nueva instancia de la clase SqlConnection.

public:
 SqlConnection();

public SqlConnection ();

Public Sub New ()

Ejemplos

En el ejemplo siguiente se crea y se abre .SqlConnection

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        OpenSqlConnection();
        Console.ReadLine();
    }

    private static void OpenSqlConnection()
    {
        string connectionString = GetConnectionString();
        using (SqlConnection connection = new SqlConnection(connectionString))
        {
            connection.Open();
            Console.WriteLine("ServerVersion: {0}", connection.ServerVersion);
            Console.WriteLine("State: {0}", connection.State);
        }
    }

    static private string GetConnectionString()
    {
        // To avoid storing the connection string in your code, 
        // you can retrieve it from a configuration file, using the 
        // System.Configuration.ConfigurationManager.ConnectionStrings property 
        return "Data Source=(local);Initial Catalog=AdventureWorks;"
            + "Integrated Security=SSPI;";
    }
}

Comentarios

Cuando se crea una nueva instancia de , las propiedades de SqlConnection lectura y escritura se establecen en los siguientes valores iniciales, a menos que se establezcan específicamente mediante sus palabras clave asociadas en la ConnectionString propiedad .

Propiedades	Valor inicial
ConnectionString	cadena vacía ("")
ConnectionTimeout	15
Database	cadena vacía ("")
DataSource	cadena vacía ("")

Solo puede cambiar el valor de estas propiedades mediante la ConnectionString propiedad . La SqlConnectionStringBuilder clase proporciona funcionalidad para crear y administrar el contenido de las cadenas de conexión.

SqlConnection(String)

Inicializa una nueva instancia de la clase SqlConnection, dada una cadena que contiene la cadena de conexión.

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

public SqlConnection (string connectionString);

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

Public Sub New (connectionString As String)

Parámetros

connectionString

String

Conexión usada para abrir la base de datos de SQL Server.

Excepciones

ArgumentException

Error de validación del argumento ConnectionString de cadena de conexión proporcionado.

Ejemplos

En el ejemplo siguiente se crea y se abre .SqlConnection

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        OpenSqlConnection();
        Console.ReadLine();
    }

    private static void OpenSqlConnection()
    {
        string connectionString = GetConnectionString();

        using (SqlConnection connection = new SqlConnection(connectionString))
        {
            connection.Open();

            Console.WriteLine("State: {0}", connection.State);
            Console.WriteLine("ConnectionString: {0}",
                connection.ConnectionString);
        }
    }

    static private string GetConnectionString()
    {
        // To avoid storing the connection string in your code, 
        // you can retrieve it from a configuration file, using the 
        // System.Configuration.ConfigurationSettings.AppSettings property 
        return "Data Source=(local);Initial Catalog=AdventureWorks;"
            + "Integrated Security=SSPI;";
    }
}

Comentarios

Cuando se crea una nueva instancia de , las propiedades de SqlConnection lectura y escritura se establecen en los siguientes valores iniciales, a menos que se establezcan específicamente mediante sus palabras clave asociadas en la ConnectionString propiedad .

Propiedades	Valor inicial
ConnectionString	connectionString
ConnectionTimeout	15
Database	cadena vacía ("")
DataSource	cadena vacía ("")

Solo puede cambiar el valor de estas propiedades mediante la ConnectionString propiedad . La SqlConnection clase proporciona funcionalidad para crear y administrar el contenido de las cadenas de conexión.

SqlConnection(String, SqlCredential)

Inicializa una nueva instancia de la clase SqlConnection a la que se proporciona una cadena de conexión que no usa Integrated Security = true y un objeto SqlCredential que contiene el identificador de usuario y la contraseña.

public:
 SqlConnection(System::String ^ connectionString, Microsoft::Data::SqlClient::SqlCredential ^ credential);

public SqlConnection (string connectionString, Microsoft.Data.SqlClient.SqlCredential credential);

new Microsoft.Data.SqlClient.SqlConnection : string * Microsoft.Data.SqlClient.SqlCredential -> Microsoft.Data.SqlClient.SqlConnection

Public Sub New (connectionString As String, credential As SqlCredential)

Parámetros

connectionString

String

Cadena de conexión que no usa ninguna de las palabras clave siguientes de cadena de conexión: Integrated Security = true, UserId o Password; o que no usa ContextConnection = true.

credential

SqlCredential

Un objeto SqlCredential. Si credential es null, SqlConnection(String, SqlCredential) es funcionalmente equivalente a SqlConnection(String).

Excepciones

ArgumentException

Los argumentos proporcionados no se pudieron validar, incluida ConnectionString la validación.