System.Data.SqlClient Espacio de nombres
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
El System.Data.SqlClient espacio de nombres es el proveedor de datos .NET para SQL Server.
Importante
Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Este espacio de nombres documenta el proveedor heredado para las aplicaciones existentes y .NET escenarios específicos de Framework que lo requieren.
Clases
| Nombre | Description |
|---|---|
| SqlAuthenticationInitializer |
Define el comportamiento principal de los inicializadores de autenticación que se pueden registrar en el archivo app.config y proporciona una base para las clases derivadas. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlAuthenticationParameters |
Representa los parámetros de autenticación de AD pasados por un controlador a proveedores de autenticación. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlAuthenticationProvider |
Define el comportamiento principal de los proveedores de autenticación y proporciona una clase base para las clases derivadas. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlAuthenticationToken |
Representa un token de autenticación de AD. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlBulkCopy |
Permite cargar de forma eficaz una tabla SQL Server de forma masiva con datos de otro origen. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlBulkCopyColumnMapping |
Define la asignación entre una columna en el origen de datos de una SqlBulkCopy instancia y una columna de la tabla de destino de la instancia. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlBulkCopyColumnMappingCollection |
Colección de SqlBulkCopyColumnMapping objetos que hereda de CollectionBase. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlClientFactory |
Representa un conjunto de métodos para crear instancias del proveedor de System.Data.SqlClient de las clases de origen de datos. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlClientLogger |
Representa un registrador de cliente SQL. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlClientMetaDataCollectionNames |
Proporciona una lista de constantes para su uso con el método GetSchema para recuperar colecciones de metadatos. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlClientPermission |
Permite que el proveedor de datos de .NET Framework para SQL Server ayude a asegurarse de que un usuario tiene un nivel de seguridad suficiente para acceder a un origen de datos. Esta API admite la seguridad de acceso al código de .NET Framework. Para el desarrollo de bases de datos nuevas, use Microsoft. Data.SqlClient; conserve esta API para las aplicaciones que requieren la seguridad de acceso al código de .NET Framework. |
| SqlClientPermissionAttribute |
Asocia una acción de seguridad a un atributo de seguridad personalizado. Esta API admite la seguridad de acceso al código de .NET Framework. Para el desarrollo de bases de datos nuevas, use Microsoft. Data.SqlClient; conserve esta API para las aplicaciones que requieren la seguridad de acceso al código de .NET Framework. |
| SqlColumnEncryptionCertificateStoreProvider |
Implementación del proveedor de almacén de claves para Windows Almacén de certificados. Esta clase habilita el uso de certificados almacenados en el almacén de certificados de Windows como claves maestras de columna. Para obtener más información, consulte Always Encrypted. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlColumnEncryptionCngProvider |
La implementación del proveedor del almacén de CMK para usar la API de criptografía de Microsoft: Next Generation (CNG) con Always Encrypted. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlColumnEncryptionCspProvider |
La implementación del proveedor del almacén de CMK para usar Microsoft proveedores de servicios criptográficos basados en CAPI (CSP) con Always Encrypted. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlColumnEncryptionEnclaveProvider |
Clase base que define la interfaz para los proveedores de enclaves para Always Encrypted. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlColumnEncryptionKeyStoreProvider |
Clase base de todos los proveedores del almacén de claves. Un proveedor personalizado debe derivar de esta clase e invalidar sus funciones miembro y, a continuación, registrarla mediante SqlConnection.RegisterColumnEncryptionKeyStoreProviders(). Para obtener más información, consulte Always Encrypted. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlCommand |
Representa una instrucción Transact-SQL o un procedimiento almacenado que se va a ejecutar en una base de datos de SQL Server. Esta clase no puede heredarse. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlCommandBuilder |
Genera automáticamente comandos de tabla única que se usan para conciliar los cambios realizados en una DataSet con la base de datos de SQL Server asociada. Esta clase no puede heredarse. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlConnection |
Representa una conexión a una base de datos de SQL Server. Esta clase no puede heredarse. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlConnectionStringBuilder |
Proporciona una manera sencilla de crear y administrar el contenido de las cadenas de conexión usadas por la clase SqlConnection. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlCredential |
SqlCredential proporciona una manera más segura de especificar la contraseña para un intento de inicio de sesión mediante la autenticación de SQL Server. SqlCredential se compone de un identificador de usuario y una contraseña que se usará para la autenticación de SQL Server. La contraseña de un SqlCredential objeto es de tipo SecureString. SqlCredential no se puede heredar. Windows Autenticación ( Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlDataAdapter |
Representa un conjunto de comandos de datos y una conexión de base de datos que se usan para rellenar el DataSet y actualizar una base de datos de SQL Server. Esta clase no puede heredarse. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlDataReader |
Proporciona una manera de leer un flujo de filas de solo avance de una base de datos de SQL Server. Esta clase no puede heredarse. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SQLDebugging |
Se incluye para admitir aplicaciones de depuración. No está pensado para uso directo. Esta API admite la depuración heredada de .NET Framework y no está pensada para su uso directo. Para el desarrollo de bases de datos nuevas, use Microsoft. Data.SqlClient. |
| SqlDependency |
El objeto SqlDependency representa una dependencia de notificación de consulta entre una aplicación y una instancia de SQL Server. Una aplicación puede crear un SqlDependency objeto y registrarse para recibir notificaciones a través del controlador de OnChangeEventHandler eventos. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlEnclaveAttestationParameters |
Encapsula la información que SqlClient envía a SQL Server para iniciar el proceso de atestación y crear una sesión segura con el enclave, SQL Server usa para cálculos en columnas protegidas mediante Always Encrypted. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlEnclaveSession |
Encapsula el estado de una sesión segura entre SqlClient y un enclave dentro de SQL Server, que se puede usar para cálculos en columnas cifradas protegidas con Always Encrypted. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlError |
Recopila información relevante para una advertencia o error devuelto por SQL Server. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlErrorCollection |
Recopila todos los errores generados por el proveedor de datos de .NET Framework para SQL Server. Esta clase no puede heredarse. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlException |
Excepción que se produce cuando SQL Server devuelve una advertencia o un error. Esta clase no puede heredarse. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlInfoMessageEventArgs |
Proporciona datos para el evento InfoMessage. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlNotificationEventArgs |
Representa el conjunto de argumentos pasados al controlador de eventos de notificación. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlParameter |
Representa un parámetro a y, opcionalmente, su asignación SqlCommand a DataSet columnas. Esta clase no puede heredarse. Para obtener más información sobre los parámetros, vea Configurar parámetros y tipos de datos de parámetros. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlParameterCollection |
Representa una colección de parámetros asociados a SqlCommand y sus respectivas asignaciones a columnas de .DataSet Esta clase no puede heredarse. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlProviderServices |
Implementación de DbProviderServices para el proveedor SqlClient para SQL Server. Conserve esta API para el proveedor integrado de Entity Framework de .NET Framework. Para el desarrollo de bases de datos nuevas, consulte Microsoft. Data.SqlClient. |
| SqlRowsCopiedEventArgs |
Representa el conjunto de argumentos pasados a .SqlRowsCopiedEventHandler Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlRowUpdatedEventArgs |
Proporciona datos para el evento RowUpdated. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlRowUpdatingEventArgs |
Proporciona datos para el evento RowUpdating. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlTransaction |
Representa una transacción Transact-SQL que se va a realizar en una base de datos SQL Server. Esta clase no puede heredarse. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
Enumeraciones
| Nombre | Description |
|---|---|
| ApplicationIntent |
Especifica un valor para ApplicationIntent. Los valores posibles son Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| PoolBlockingPeriod |
Especifica un valor para la propiedad PoolBlockingPeriod. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SortOrder |
Especifica cómo se ordenan las filas de datos. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlAuthenticationMethod |
Describe los distintos métodos de autenticación de SQL que puede usar un cliente que se conecta a Azure SQL Database. Para obtener más información, consulte Connecting to SQL Database By Using Azure Active Directory Authentication. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlBulkCopyOptions |
Marca bit a bit que especifica una o varias opciones que se van a usar con una instancia de SqlBulkCopy. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlCommandColumnEncryptionSetting |
Especifica cómo se enviarán y recibirán los datos al leer y escribir columnas cifradas. Según la consulta específica, el impacto en el rendimiento puede reducirse si se pasa el procesamiento del controlador Always Encrypted cuando se usan columnas no cifradas. Tenga en cuenta que esta configuración no se puede usar para omitir el cifrado y obtener acceso a datos de texto no cifrado. Para obtener más información, consulte Always Encrypted (Motor de base de datos). Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlConnectionColumnEncryptionSetting |
Especifica que la funcionalidad de Always Encrypted está habilitada en una conexión. Tenga en cuenta que esta configuración no se puede usar para omitir el cifrado y obtener acceso a datos de texto no cifrado. Para obtener más información, consulte Always Encrypted (Motor de base de datos). Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlNotificationInfo |
Esta enumeración proporciona información adicional sobre las diferentes notificaciones que el controlador de eventos de dependencia puede recibir. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlNotificationSource |
Indica el origen de la notificación recibida por el controlador de eventos de dependencia. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlNotificationType |
Describe los distintos tipos de notificación que puede recibir un controlador de eventos OnChangeEventHandler a través del parámetro SqlNotificationEventArgs. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
Delegados
| Nombre | Description |
|---|---|
| OnChangeEventHandler |
Controla el OnChange evento que se desencadena cuando se recibe una notificación para cualquiera de los comandos asociados a un SqlDependency objeto . Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlInfoMessageEventHandler |
Representa el método que controlará el InfoMessage evento de .SqlConnection Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlRowsCopiedEventHandler |
Representa el método que controla el SqlRowsCopied evento de un SqlBulkCopyobjeto . Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlRowUpdatedEventHandler |
Representa el método que controlará el RowUpdated evento de .SqlDataAdapter Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| SqlRowUpdatingEventHandler |
Representa el método que controlará el RowUpdating evento de .SqlDataAdapter Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
Comentarios
Note
Las System.Data.SqlClient API están en desuso. Para el desarrollo nuevo, use las API de Microsoft.Data.SqlClient.
El .NET Proveedor de datos de SQL Server describe una colección de clases usadas para acceder a una base de datos de SQL Server en el espacio administrado. SqlDataAdapterCon , puede rellenar un residente DataSet en memoria que puede usar para consultar y actualizar la base de datos.
Note
Para obtener información conceptual sobre cómo usar este espacio de nombres al programar con .NET, vea SQL Server y ADO.NET.