System.Data.SqlClient Namespace
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 ( 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: 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.