System.Data.SqlClient Espacio de nombres

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 (Integrated Security = true) sigue siendo la manera más segura de iniciar sesión en una base de datos de SQL Server.

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 ReadWrite y ReadOnly.

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.