Compartir a través de


SqlConnection Constructores

Definición

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.

Se aplica a

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

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.

Se aplica a

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

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

Se aplica a