Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase SqlConnection

 

Representa una conexión abierta a una base de datos de SQL Server. Esta clase no puede heredarse.

Espacio de nombres:   System.Data.SqlClient
Ensamblado:  System.Data (en System.Data.dll)

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Data.Common.DbConnection
        System.Data.SqlClient.SqlConnection

public sealed class SqlConnection : DbConnection, ICloneable

NombreDescripción
System_CAPS_pubmethodSqlConnection()

Inicializa una nueva instancia de la clase SqlConnection.

System_CAPS_pubmethodSqlConnection(String)

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

System_CAPS_pubmethodSqlConnection(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.

NombreDescripción
System_CAPS_pubpropertyAccessToken

Obtiene o establece el token de acceso para la conexión.

System_CAPS_pubpropertyClientConnectionId

Identificador de conexión del intento de conexión más reciente, independientemente de si el intento se realizó correctamente o no.

System_CAPS_pubpropertySystem_CAPS_staticColumnEncryptionKeyCacheTtl

Obtiene o establece el tiempo de vida para el cifrado de columna claves entradas en la caché de clave de cifrado de columna para la Always Encrypted característica. El valor predeterminado es 2 horas. 0 significa que no hay almacenamiento en caché en absoluto.

System_CAPS_pubpropertySystem_CAPS_staticColumnEncryptionQueryMetadataCacheEnabled

Obtiene o establece un valor que indica si está habilitado el almacenamiento en caché de metadatos de consulta (true) o no (false) para las consultas con parámetros que se ejecuta en Always Encrypted habilitado las bases de datos. El valor predeterminado es true.

System_CAPS_pubpropertySystem_CAPS_staticColumnEncryptionTrustedMasterKeyPaths

Le permite establecer una lista de rutas de acceso a clave de confianza para un servidor de base de datos. Si durante el procesamiento de una consulta de aplicación, el controlador recibe una ruta de acceso de clave que no se encuentre en la lista, la consulta generará error. Esta propiedad ofrece protección adicional contra los ataques de seguridad que implican un SQL que está en peligro al ofrecer rutas de acceso de clave falsas, lo que puede provocar la pérdida de las credenciales del almacén de claves.

System_CAPS_pubpropertyConnectionString

Obtiene o establece la cadena que se utiliza para abrir una base de datos SQL Server.(Invalida DbConnection.ConnectionString).

System_CAPS_pubpropertyConnectionTimeout

Obtiene el tiempo de espera para intentar establecer una conexión antes de detenerse y generar un error.(Invalida DbConnection.ConnectionTimeout).

System_CAPS_pubpropertyContainer

Obtiene IContainer que contiene Component.(Heredado de Component).

System_CAPS_pubpropertyCredential

Obtiene o establece el objeto SqlCredential para esta conexión.

System_CAPS_pubpropertyDatabase

Obtiene el nombre de la base de datos actual o de la que se va a utilizar una vez que se abre la conexión.(Invalida DbConnection.Database).

System_CAPS_pubpropertyDataSource

Obtiene el nombre de la instancia de SQL Server con la que se va a establecer la conexión.(Invalida DbConnection.DataSource).

System_CAPS_pubpropertyFireInfoMessageEventOnUserErrors

Obtiene o establece la propiedad FireInfoMessageEventOnUserErrors.

System_CAPS_pubpropertyPacketSize

Obtiene el tamaño en bytes de los paquetes de red utilizados para establecer comunicación con una instancia de SQL Server.

System_CAPS_pubpropertyServerVersion

Obtiene una cadena que contiene la versión de la instancia de SQL Server a la que se conecta el cliente.(Invalida DbConnection.ServerVersion).

System_CAPS_pubpropertySite

Obtiene o establece la ISite de la Component.(Heredado de Component).

System_CAPS_pubpropertyState

Indica el estado de SqlConnection durante la operación más reciente de la red realizada en la conexión.(Invalida DbConnection.State).

System_CAPS_pubpropertyStatisticsEnabled

Cuando se establece en true, permite la obtención de estadísticas para la conexión actual.

System_CAPS_pubpropertyWorkstationId

Obtiene una cadena que identifica el cliente de bases de datos.

NombreDescripción
System_CAPS_pubmethodBeginTransaction()

Inicia una transacción de base de datos.

System_CAPS_pubmethodBeginTransaction(IsolationLevel)

Inicia una transacción de base de datos con el nivel de aislamiento especificado.

System_CAPS_pubmethodBeginTransaction(IsolationLevel, String)

Inicia una transacción de la base de datos con el nivel de aislamiento y el nombre de transacción especificados.

System_CAPS_pubmethodBeginTransaction(String)

Inicia una transacción de base de datos con el nombre de transacción especificado.

System_CAPS_pubmethodChangeDatabase(String)

Cambia la base de datos actual de una conexión SqlConnection abierta.(Invalida DbConnection.ChangeDatabase(String)).

System_CAPS_pubmethodSystem_CAPS_staticChangePassword(String, SqlCredential, SecureString)

Cambia la contraseña de SQL Server para el usuario indicado en el objeto de SqlCredential.

System_CAPS_pubmethodSystem_CAPS_staticChangePassword(String, String)

Cambia la contraseña de SQL Server para el usuario indicado en la cadena de conexión a la nueva contraseña proporcionada.

System_CAPS_pubmethodSystem_CAPS_staticClearAllPools()

Vacía la agrupación de conexiones.

System_CAPS_pubmethodSystem_CAPS_staticClearPool(SqlConnection)

Vacía la agrupación de conexiones asociada a la conexión especificada.

System_CAPS_pubmethodClose()

Cierra la conexión con la base de datos. Es el método preferido para cerrar cualquier conexión abierta.(Invalida DbConnection.Close()).

System_CAPS_pubmethodCreateCommand()

Crea y devuelve un objeto SqlCommand asociado a la conexión SqlConnection.

System_CAPS_pubmethodCreateObjRef(Type)

Crea un objeto que contiene toda la información relevante necesaria para generar a un proxy que se utiliza para comunicarse con un objeto remoto.(Heredado de MarshalByRefObject).

System_CAPS_pubmethodDispose()

Libera todos los recursos que usa Component.(Heredado de Component).

System_CAPS_pubmethodEnlistDistributedTransaction(ITransaction)

Se da de alta en la transacción especificada como una transacción distribuida.

System_CAPS_pubmethodEnlistTransaction(Transaction)

Se da de alta en la transacción especificada como una transacción distribuida.(Invalida DbConnection.EnlistTransaction(Transaction)).

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.(Heredado de MarshalByRefObject).

System_CAPS_pubmethodGetSchema()

Devuelve información de esquema para el origen de datos de SqlConnection. Para obtener más información acerca del esquema, consulte SQL Server Schema Collections.(Invalida DbConnection.GetSchema()).

System_CAPS_pubmethodGetSchema(String)

Devuelve información de esquema para el origen de datos de SqlConnection utilizando la cadena especificada para el nombre del esquema.(Invalida DbConnection.GetSchema(String)).

System_CAPS_pubmethodGetSchema(String, String[])

Devuelve información de esquema para el origen de datos de SqlConnection utilizando la cadena especificada para el nombre del esquema y la matriz de cadena determinada para los valores de restricción.(Invalida DbConnection.GetSchema(String, String[])).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodInitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.(Heredado de MarshalByRefObject).

System_CAPS_pubmethodOpen()

Abre una conexión de base de datos con los valores de propiedad que especifica ConnectionString.(Invalida DbConnection.Open()).

System_CAPS_pubmethodOpenAsync()

Una versión asincrónica de Open, que abre una conexión de base de datos con la configuración especificada por el ConnectionString. Este método invoca el método virtual OpenAsync con CancellationToken.None.(Heredado de DbConnection).

System_CAPS_pubmethodOpenAsync(CancellationToken)

Una versión asincrónica de Open, que abre una conexión a bases de datos con los valores de propiedad especificados por ConnectionString. Token de cancelación que se puede usar para solicitar que se abandone la operación antes de que transcurra el tiempo de espera de la conexión. Las excepciones se propagarán mediante la tarea devuelta. Si el tiempo de espera de conexión transcurre sin conectar correctamente, la tarea devuelta se marcará como error con una excepción. La implementación devuelve una tarea sin bloquear el subproceso de llamada para las conexiones agrupadas y no agrupadas.(Invalida DbConnection.OpenAsync(CancellationToken)).

System_CAPS_pubmethodSystem_CAPS_staticRegisterColumnEncryptionKeyStoreProviders(IDictionary<String, SqlColumnEncryptionKeyStoreProvider>)

Registra los proveedores de almacenamiento de claves de cifrado de columnas.

System_CAPS_pubmethodResetStatistics()

Si se habilita la obtención de estadísticas, todos los valores se restablecen en cero.

System_CAPS_pubmethodRetrieveStatistics()

Devuelve una colección de pares de nombre y valor de las estadísticas cuando se llama el método.

System_CAPS_pubmethodToString()

Devuelve un String que contiene el nombre de la Component, si existe. Este método no se debe invalidar.(Heredado de Component).

NombreDescripción
System_CAPS_pubeventDisposed

Se produce cuando el componente se elimina mediante una llamada a la Dispose (método).(Heredado de Component).

System_CAPS_pubeventInfoMessage

Se produce cuando SQL Server devuelve un mensaje informativo o de advertencia.

System_CAPS_pubeventStateChange

Se produce cuando cambia el estado del evento.(Heredado de DbConnection).

NombreDescripción
System_CAPS_pubinterfaceSystem_CAPS_privmethodIDbConnection.BeginTransaction()

Inicia una transacción de base de datos.(Heredado de DbConnection).

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDbConnection.BeginTransaction(IsolationLevel)

Inicia una transacción de base de datos con el valor de IsolationLevel especificado.(Heredado de DbConnection).

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDbConnection.CreateCommand()

Crea y devuelve un objeto DbCommand asociado a la conexión actual.(Heredado de DbConnection).

System_CAPS_pubinterfaceSystem_CAPS_privmethodICloneable.Clone()

Crea un nuevo objeto copiado de la instancia actual.

A SqlConnection objeto representa una sesión única a un SQL Server origen de datos. Con un sistema de base de datos cliente/servidor, es equivalente a una conexión de red al servidor. SqlConnectionse utiliza junto con SqlDataAdapter y SqlCommand para aumentar el rendimiento cuando se conecta a Microsoft SQL Server base de datos. Para todas las aplicaciones de terceros SQL Server productos y otros orígenes de datos compatibles con OLE DB, utilizan OleDbConnection.

Cuando se crea una instancia de SqlConnection, todas las propiedades se establecen en sus valores iniciales. Para obtener una lista de estos valores, consulte el SqlConnection constructor.

Consulte ConnectionString para obtener una lista de las palabras clave en una cadena de conexión.

Si la SqlConnection queda fuera del ámbito, no se cerrará. Por lo tanto, debe cerrar la conexión explícitamente mediante una llamada a Close o Dispose. Closey Dispose son funcionalmente equivalentes. Si la agrupación de conexiones de los valores Pooling está establecido en true o yes, la conexión subyacente se devuelve a la agrupación de conexiones. Por otro lado, si Pooling está establecido en false o no, la conexión al servidor subyacente está cerrada realmente.

System_CAPS_noteNota

Los eventos de inicio y cierre de sesión no se provocarán en el servidor cuando se busque una conexión desde el grupo de conexiones o se devuelva a éste, puesto que la conexión no está cerrada realmente cuando se devuelve al grupo de conexiones. Para obtener más información, consulta Agrupación de conexiones en SQL Server (ADO.NET).

Para asegurarse de que siempre se cierran las conexiones, abra la conexión dentro de un using bloquear, tal como se muestra en el siguiente fragmento de código. Este modo se asegura que la conexión se cierra automáticamente cuando el código sale del bloque.

using (SqlConnection connection = new SqlConnection(connectionString))
    {
        connection.Open();
        // Do work here; connection closed on following line.
    }
System_CAPS_noteNota

Para implementar aplicaciones de alto rendimiento, debe usar la agrupación de conexiones. Cuando se usa el .NET Framework proveedor de datos para SQL Server, no es necesario habilitar la agrupación de conexiones porque el proveedor encarga de ello automáticamente, aunque se pueden modificar algunos valores de configuración. Para obtener más información, consulta Agrupación de conexiones en SQL Server (ADO.NET).

Si un SqlException generado por el método que ejecuta un SqlCommand, el SqlConnection permanece abierta cuando el nivel de gravedad es 19 o inferior. Cuando el nivel de gravedad es 20 o superior, el servidor normalmente cierra el SqlConnection. Sin embargo, el usuario puede volver a abrir la conexión y continuar.

Una aplicación que crea una instancia de la SqlConnection objeto puede requerir que todos los llamadores directos e indirectos tengan permisos suficientes en el código mediante el establecimiento de las peticiones de seguridad declarativo o imperativo. SqlConnectionhace que las peticiones de seguridad mediante la SqlClientPermission objeto. Los usuarios pueden comprobar que su código tiene los permisos necesarios mediante la SqlClientPermissionAttribute objeto. Los usuarios y administradores también pueden utilizar el Caspol.exe (Code Access Security Policy Tool) para modificar la directiva de seguridad en los niveles de equipo, usuario y empresa. Para obtener más información, consulta Security in the .NET Framework. Para obtener un ejemplo que muestra cómo usar las peticiones de seguridad, consulte Seguridad de acceso del código y ADO.NET.

Para obtener más información sobre el control de mensajes de advertencia e informativos desde el servidor, consulte Eventos de conexión.SQL Servererrores del motor y mensajes de error se documentan en SQL Server libros en pantalla.

System_CAPS_cautionPrecaución

Puede forzar TCP en lugar de la memoria compartida. Puede hacerlo agregando el prefijo tcp: para el nombre del servidor en la conexión de cadena, o bien puede usar localhost.

En el ejemplo siguiente se crea un SqlCommand y SqlConnection. El SqlConnection se abre y se establece como el Connection para el SqlCommand. El ejemplo, a continuación, se llama ExecuteNonQuery. Para lograr esto, la ExecuteNonQuery se pasa una cadena de conexión y una cadena de consulta que es una Transact-SQL instrucción INSERT. La conexión se cierra automáticamente cuando el código sale del uso de bloque.

private static void CreateCommand(string queryString,
    string connectionString)
{
    using (SqlConnection connection = new SqlConnection(
               connectionString))
    {
        SqlCommand command = new SqlCommand(queryString, connection);
        command.Connection.Open();
        command.ExecuteNonQuery();
    }
}

.NET Framework
Disponible desde 1.1

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: