System.Data.SqlClient Namespace

O System.Data.SqlClient namespace é o Provedor de Dados do .NET para SQL Server.

Importante

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esse namespace documenta o provedor herdado para aplicativos existentes e .NET cenários específicos da Estrutura que o exigem.

Classes

Nome Description
SqlAuthenticationInitializer

Define o comportamento principal de inicializadores de autenticação que podem ser registrados no arquivo app.config e fornece uma base para classes derivadas.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlAuthenticationParameters

Representa os parâmetros de autenticação do AD passados por um driver para provedores de autenticação.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlAuthenticationProvider

Define o comportamento principal dos provedores de autenticação e fornece uma classe base para classes derivadas.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlAuthenticationToken

Representa um token de autenticação do AD.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlBulkCopy

Permite carregar com eficiência uma tabela SQL Server com dados de outra fonte.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlBulkCopyColumnMapping

Define o mapeamento entre uma coluna na fonte de dados de uma SqlBulkCopy instância e uma coluna na tabela de destino da instância.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlBulkCopyColumnMappingCollection

Coleção de SqlBulkCopyColumnMapping objetos que herda de CollectionBase.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlClientFactory

Representa um conjunto de métodos para criar instâncias do System.Data.SqlClient implementação do provedor das classes de fonte de dados.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlClientLogger

Representa um agente do cliente SQL.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlClientMetaDataCollectionNames

Fornece uma lista de constantes para uso com o método GetSchema para recuperar coleções de metadados.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlClientPermission

Permite que o Provedor de Dados do .NET Framework para SQL Server ajude a garantir que um usuário tenha um nível de segurança suficiente para acessar uma fonte de dados.

Essa API dá suporte à segurança de acesso ao código do .NET Framework. Para o desenvolvimento do novo banco de dados, use Microsoft. Data.SqlClient; mantenha essa API para aplicativos que exigem segurança de acesso ao código do .NET Framework.

SqlClientPermissionAttribute

Associa uma ação de segurança a um atributo de segurança personalizado.

Essa API dá suporte à segurança de acesso ao código do .NET Framework. Para o desenvolvimento do novo banco de dados, use Microsoft. Data.SqlClient; mantenha essa API para aplicativos que exigem segurança de acesso ao código do .NET Framework.

SqlColumnEncryptionCertificateStoreProvider

A implementação do provedor de repositório de chaves para Windows Repositório de Certificados. Essa classe permite usar certificados armazenados no Repositório de Certificados Windows como chaves mestras de coluna. Para obter detalhes, consulte Always Encrypted.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlColumnEncryptionCngProvider

A implementação do provedor da CMK Store para usar a API de Criptografia Microsoft: CNG (Próxima Geração) com Always Encrypted.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlColumnEncryptionCspProvider

A implementação do provedor da CMK Store para usar Microsoft CSP (Provedores de Serviços Criptográficos) baseados em CAPI com Always Encrypted.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlColumnEncryptionEnclaveProvider

A classe base que define a interface para provedores de enclave para Always Encrypted.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlColumnEncryptionKeyStoreProvider

Classe base para todos os provedores de repositório de chaves. Um provedor personalizado deve derivar dessa classe e substituir suas funções membro e registrá-la usando SqlConnection.RegisterColumnEncryptionKeyStoreProviders(). Para obter detalhes, consulte Always Encrypted.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlCommand

Representa uma instrução Transact-SQL ou um procedimento armazenado a ser executado em um banco de dados SQL Server. Essa classe não pode ser herdada.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlCommandBuilder

Gera automaticamente comandos de tabela única que são usados para reconciliar alterações feitas em um DataSet com o banco de dados SQL Server associado. Essa classe não pode ser herdada.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlConnection

Representa uma conexão com um banco de dados SQL Server. Essa classe não pode ser herdada.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlConnectionStringBuilder

Fornece uma maneira simples de criar e gerenciar o conteúdo das cadeias de conexão usadas pela classe SqlConnection.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlCredential

SqlCredential fornece uma maneira mais segura de especificar a senha para uma tentativa de logon usando SQL Server Autenticação.

SqlCredential é composto por uma ID de usuário e uma senha que será usada para autenticação SQL Server. A senha em um SqlCredential objeto é do tipo SecureString.

SqlCredential não pode ser herdado.

Windows Autenticação (Integrated Security = true) continua sendo a maneira mais segura de fazer logon em um banco de dados SQL Server.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlDataAdapter

Representa um conjunto de comandos de dados e uma conexão de banco de dados que são usados para preencher o DataSet e atualizar um banco de dados SQL Server. Essa classe não pode ser herdada.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlDataReader

Fornece uma maneira de ler um fluxo somente de encaminhamento de linhas de um banco de dados SQL Server. Essa classe não pode ser herdada.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SQLDebugging

Incluído para dar suporte à depuração de aplicativos. Não destinado ao uso direto.

Essa API dá suporte à depuração herdada do .NET Framework e não se destina ao uso direto. Para o desenvolvimento do novo banco de dados, use Microsoft. Data.SqlClient.

SqlDependency

O objeto SqlDependency representa uma dependência de notificação de consulta entre um aplicativo e uma instância de SQL Server. Um aplicativo pode criar um SqlDependency objeto e registrar-se para receber notificações por meio do OnChangeEventHandler manipulador de eventos.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlEnclaveAttestationParameters

Encapsula as informações que o SqlClient envia para SQL Server para iniciar o processo de atestar e criar uma sessão segura com o enclave, SQL Server usa para cálculos em colunas protegidas usando o Always Encrypted.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlEnclaveSession

Encapsula o estado de uma sessão segura entre SqlClient e um enclave dentro de SQL Server, que pode ser usado para cálculos em colunas criptografadas protegidas com Always Encrypted.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlError

Coleta informações relevantes para um aviso ou erro retornado por SQL Server.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlErrorCollection

Coleta todos os erros gerados pelo Provedor de Dados do .NET Framework para SQL Server. Essa classe não pode ser herdada.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlException

A exceção gerada quando SQL Server retorna um aviso ou erro. Essa classe não pode ser herdada.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlInfoMessageEventArgs

Fornece dados para o evento InfoMessage.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlNotificationEventArgs

Representa o conjunto de argumentos passados para o manipulador de eventos de notificação.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlParameter

Representa um parâmetro para um SqlCommand e, opcionalmente, seu mapeamento para DataSet colunas. Essa classe não pode ser herdada. Para obter mais informações sobre parâmetros, consulte Configurando parâmetros e tipos de dados de parâmetro.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlParameterCollection

Representa uma coleção de parâmetros associados a um SqlCommand e seus respectivos mapeamentos para colunas em um DataSet. Essa classe não pode ser herdada.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlProviderServices

A implementação de DbProviderServices para o provedor sqlClient para SQL Server.

Mantenha essa API para o provedor interno .NET Framework Entity Framework. Para obter um novo desenvolvimento de banco de dados, consulte Microsoft. Data.SqlClient.

SqlRowsCopiedEventArgs

Representa o conjunto de argumentos passados para o SqlRowsCopiedEventHandler.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlRowUpdatedEventArgs

Fornece dados para o evento RowUpdated.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlRowUpdatingEventArgs

Fornece dados para o evento RowUpdating.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlTransaction

Representa uma transação Transact-SQL a ser feita em um banco de dados SQL Server. Essa classe não pode ser herdada.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

Enumerações

Nome Description
ApplicationIntent

Especifica um valor para ApplicationIntent. Os valores possíveis são: ReadWrite e ReadOnly.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

PoolBlockingPeriod

Especifica um valor para a propriedade PoolBlockingPeriod.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SortOrder

Especifica como as linhas de dados são classificadas.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlAuthenticationMethod

Descreve os diferentes métodos de autenticação SQL que podem ser usados por um cliente que se conecta a Banco de Dados SQL do Azure. Para obter detalhes, consulte Conectando para o Banco de Dados SQL usando Azure Active Directory Autenticação.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlBulkCopyOptions

Sinalizador bit a bit que especifica uma ou mais opções a serem usadas com uma instância de SqlBulkCopy.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlCommandColumnEncryptionSetting

Especifica como os dados serão enviados e recebidos ao ler e gravar colunas criptografadas. Dependendo da consulta específica, o impacto no desempenho pode ser reduzido ignorando o processamento do driver Always Encrypted quando colunas não criptografadas estão sendo usadas. Observe que essas configurações não podem ser usadas para ignorar a criptografia e obter acesso a dados de texto não criptografado. Para obter detalhes, consulte Always Encrypted (Mecanismo de Banco de Dados).

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlConnectionColumnEncryptionSetting

Especifica que a funcionalidade Always Encrypted está habilitada em uma conexão. Observe que essas configurações não podem ser usadas para ignorar a criptografia e obter acesso a dados de texto não criptografado. Para obter detalhes, consulte Always Encrypted (Mecanismo de Banco de Dados).

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlNotificationInfo

Essa enumeração fornece informações adicionais sobre as diferentes notificações que podem ser recebidas pelo manipulador de eventos de dependência.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlNotificationSource

Indica a origem da notificação recebida pelo manipulador de eventos de dependência.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlNotificationType

Descreve os diferentes tipos de notificação que podem ser recebidos por um manipulador de eventos OnChangeEventHandler por meio do parâmetro SqlNotificationEventArgs.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

Delegados

Nome Description
OnChangeEventHandler

Manipula o OnChange evento que é acionado quando uma notificação é recebida para qualquer um dos comandos associados a um SqlDependency objeto.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlInfoMessageEventHandler

Representa o método que manipulará o InfoMessage evento de um SqlConnection.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlRowsCopiedEventHandler

Representa o método que manipula o SqlRowsCopied evento de um SqlBulkCopy.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlRowUpdatedEventHandler

Representa o método que manipulará o RowUpdated evento de um SqlDataAdapter.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

SqlRowUpdatingEventHandler

Representa o método que manipulará o RowUpdating evento de um SqlDataAdapter.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

Comentários

Note

As System.Data.SqlClient APIs foram preteridas. Para um novo desenvolvimento, use as APIs Microsoft.Data.SqlClient.

O .NET Provedor de Dados para SQL Server descreve uma coleção de classes usadas para acessar um banco de dados SQL Server no espaço gerenciado. Usando o SqlDataAdapter, você pode preencher um residente DataSet de memória que pode ser usado para consultar e atualizar o banco de dados.

Note

Para obter informações conceituais sobre como usar esse namespace ao programar com .NET, consulte SQL Server e ADO.NET.