Compartir a través de


SqlConnection Constructores

Definición

Inicializa una nueva instancia de la clase SqlConnection.

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

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;";
}
Private Sub OpenSqlConnection()
    Dim connectionString As String = GetConnectionString()
    Using connection As New SqlConnection(connectionString)
        connection.Open()
        Console.WriteLine("ServerVersion: {0}", connection.ServerVersion)
        Console.WriteLine("State: {0}", connection.State)
    End Using
End Sub

Private Function GetConnectionString() As String
    ' 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);Database=AdventureWorks;" _
      & "Integrated Security=SSPI;"
End Function

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.

Consulte tambié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 System.Data.SqlClient.SqlConnection : string -> System.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 cadena de conexión proporcionado.

Ejemplos

En el ejemplo siguiente se crea y se abre .SqlConnection

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;";
}
Private Sub OpenSqlConnection()
    Dim connectionString As String = GetConnectionString()

    Using connection As New SqlConnection(connectionString)

        connection.Open()

        Console.WriteLine("State: {0}", connection.State)
        Console.WriteLine("ConnectionString: {0}", _
            connection.ConnectionString)
    End Using
End Sub

Private Function GetConnectionString() As String
    ' 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);Database=AdventureWorks;" _
      & "Integrated Security=SSPI;"
End Function

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.

Consulte tambié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, System::Data::SqlClient::SqlCredential ^ credential);
public SqlConnection (string connectionString, System.Data.SqlClient.SqlCredential credential);
new System.Data.SqlClient.SqlConnection : string * System.Data.SqlClient.SqlCredential -> System.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

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

Consulte también

Se aplica a