SqlConnection Constructores

Definición

Espacio de nombres:

System.Data.SqlClient

Ensamblado:

System.Data.dll

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

• Conectarse a un origen de datos en ADO.NET
• SQL Server y ADO.NET
• Información general de ADO.NET

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

ArgumentException

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

• Conectarse a un origen de datos (ADO.NET)
• Uso del proveedor de datos de .NET Framework para SQL Server
• Información general de ADO.NET

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

ArgumentException

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

Consulte también

• Información general de ADO.NET