El documento describe la clase SqlConnection, que representa una conexión única a una base de datos SQL Server y cómo interactúa con otros componentes como SqlDataAdapter y SqlCommand para optimizar el rendimiento. Detalla diversas propiedades y métodos, incluyendo la gestión de cadenas de conexión, manejo de transacciones y métodos para abrir y cerrar conexiones. Además, menciona aspectos de seguridad relacionados con el cifrado de columnas y control de acceso a claves de cifrado.

2. SqlConnection representa una sesión única a una fuente de datos
de SQLServer. Con un sistema de base de datos cliente / servidor,
que es equivalente a unaconexión de red al servidor.
SqlConnection se utiliza junto con SqlDataAdapter ySqlCommand
para aumentar el rendimiento cuando se conecta a una base de
datos deMicrosoft SQL Server. Cuando se crea una instancia de
SqlConnection, todas las propiedades se ajustan a susvalores
iniciales. Si la conexión SqlConnection está fuera de ámbito, no se
cerrará. Por lo tanto, espreciso cerrar explícitamente la conexión
llamando a Close o Dispose.

3. NOMBRE DESCRIPCIÓN
AccessToken Obtiene o establece el token de acceso para la conexión.
ClientConnectionId
Identificador de conexión del intento de conexión más reciente,
independientemente de si el intento se realizó correctamente o no.
ColumnEncryptionKeyCa
cheTtl
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.

4. ColumnEncryptionQu
eryMetadataCacheEn
abled
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 enAlways
Encrypted habilitado las bases de datos. El valor predeterminado es true.
ColumnEncryptionTru
stedMasterKeyPaths
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.
ConnectionString
Obtiene o establece la cadena que se utiliza para abrir una base de datos
SQL Server. (Invalida DbConnection.ConnectionString).

5. ConnectionTimeout
Obtiene el tiempo de espera para intentar establecer una conexión
antes de detenerse y generar un error.
(Invalida DbConnection.ConnectionTimeout).
Container
Obtiene IContainer que contiene Component. (Heredado
de Component).
Credential Obtiene o establece el objeto SqlCredential para esta conexión.
Database
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).

6. DataSource
Obtiene el nombre de la instancia de SQL Server con la que se va a
establecer la conexión. (Invalida DbConnection.DataSource).
FireInfoMessageEventO
nUserErrors
Obtiene o establece la propiedad FireInfoMessageEventOnUserErrors.
PacketSize
Obtiene el tamaño en bytes de los paquetes de red utilizados para
establecer comunicación con una instancia de SQL Server.
ServerVersion
Obtiene una cadena que contiene la versión de la instancia de SQL Server a
la que se conecta el cliente. (Invalida DbConnection.ServerVersion).
Site Obtiene o establece la ISite de la Component. (Heredado de Component).
State
Indica el estado de SqlConnection durante la operación más reciente de la
red realizada en la conexión. (Invalida DbConnection.State).

7. StatisticsEnabled
Cuando se establece en true, permite la obtención de
estadísticas para la conexión actual.
WorkstationId
Obtiene una cadena que identifica el cliente de bases
de datos.

8. NOMBRE DESCRIPCIÓN
BeginTransaction() Inicia una transacción de base de datos.
BeginTransaction(Isolatio
nLevel)
Inicia una transacción de base de datos con el nivel de aislamiento
especificado.
BeginTransaction(Isolatio
nLevel, String)
Inicia una transacción de la base de datos con el nivel de aislamiento y el
nombre de transacción especificados.
BeginTransaction(String)
Inicia una transacción de base de datos con el nombre de transacción
especificado.
ChangeDatabase(String)
Cambia la base de datos actual de una conexión SqlConnection abierta.
(Invalida DbConnection.ChangeDatabase(String)).

9. ChangePassword(String,
SqlCredential,
SecureString)
Cambia la contraseña de SQL Server para el usuario indicado en el objeto
de SqlCredential.
ChangePassword(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.
ClearAllPools() Vacía la agrupación de conexiones.
ClearPool(SqlConnection
)
Vacía la agrupación de conexiones asociada a la conexión especificada.
Close()
Cierra la conexión con la base de datos. Es el método preferido para cerrar
cualquier conexión abierta. (Invalida DbConnection.Close()).
CreateCommand()
Crea y devuelve un objeto SqlCommand asociado a la
conexión SqlConnection.
CreateObjRef(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).

10. Dispose() Libera todos los recursos que usa Component. (Heredado de Component).
EnlistDistributedTransac
tion(ITransaction)
Se da de alta en la transacción especificada como una transacción
distribuida.
EnlistTransaction(Transa
ction)
Se da de alta en la transacción especificada como una transacción
distribuida. (Invalida DbConnection.EnlistTransaction(Transaction)).
Equals(Object)
Determina si el objeto especificado es igual al objeto actual. (Heredado
de Object).
GetHashCode() Sirve como la función hash predeterminada. (Heredado de Object).

11. GetLifetimeService
()
Recupera el objeto de servicio de duración actual que controla la directiva de
duración de esta instancia. (Heredado de MarshalByRefObject).
GetSchema()
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()).
GetSchema(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)).
GetSchema(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())).
GetType() Obtiene el Type de la instancia actual. (Heredado de Object).

12. InitializeLifetime
Service()
Obtiene un objeto de servicio de duración para controlar la directiva de
duración de esta instancia. (Heredado de MarshalByRefObject).
Open()
Abre una conexión de base de datos con los valores de propiedad que
especificaConnectionString. (Invalida DbConnection.Open()).
OpenAsync()
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).
OpenAsync(Canc
ellationToken)
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)).

13. RegisterColumnEncryption
KeyStoreProviders(IDiction
ary(Of String,
SqlColumnEncryptionKeySt
oreProvider))
Registra los proveedores de almacenamiento de claves de cifrado
de columnas.
ResetStatistics()
Si se habilita la obtención de estadísticas, todos los valores se
restablecen en cero.
RetrieveStatistics()
Devuelve una colección de pares de nombre y valor de las
estadísticas cuando se llama el método.
ToString()
Devuelve un String que contiene el nombre de la Component, si
existe. Este método no se debe invalidar. (Heredado
de Component).

14. 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

15. 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