System.Data.SqlClient Espaço de Nomes
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
O espaço de nomes System.Data.SqlClient é o .NET Data Provider para SQL Server.
Importante
Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Este namespace documenta o fornecedor legado para aplicações existentes e cenários específicos do .NET Framework que o necessitam.
Classes
| Nome | Descrição |
|---|---|
| SqlAuthenticationInitializer |
Define o comportamento central dos inicializadores de autenticação que podem ser registados no ficheiro app.config e fornece uma base para classes derivadas. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlAuthenticationParameters |
Representa parâmetros de autenticação AD passados por um driver aos fornecedores de autenticação. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlAuthenticationProvider |
Define o comportamento central dos fornecedores de autenticação e fornece uma classe base para classes derivadas. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlAuthenticationToken |
Representa um token de autenticação AD. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlBulkCopy |
Permite-te carregar em massa de forma eficiente uma tabela SQL Server com dados de outra fonte. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o 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 novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlBulkCopyColumnMappingCollection |
Coleção de SqlBulkCopyColumnMapping objetos que herda de CollectionBase. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlClientFactory |
Representa um conjunto de métodos para criar instâncias da System.Data.SqlClient implementação das classes de fonte de dados pelo fornecedor. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlClientLogger |
Representa um gestor de cliente SQL. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlClientMetaDataCollectionNames |
Fornece uma lista de constantes para uso com o método GetSchema para recuperar coleções de metadados. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlClientPermission |
Permite que o .NET Framework Data Provider for SQL Server ajude a garantir que o utilizador tem um nível de segurança suficiente para aceder a uma fonte de dados. Esta API suporta segurança de acesso ao código .NET Framework. Para desenvolvimento de novas bases de dados, use a Microsoft. Data.SqlClient; mantenha esta API para aplicações que necessitem de 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. Esta API suporta segurança de acesso ao código .NET Framework. Para desenvolvimento de novas bases de dados, use a Microsoft. Data.SqlClient; mantenha esta API para aplicações que necessitem de segurança de acesso ao código do .NET Framework. |
| SqlColumnEncryptionCertificateStoreProvider |
A implementação do fornecedor de key store para a Windows Certificate Store. Esta classe permite a utilização de certificados armazenados na Loja de Certificados do Windows como chaves mestras de coluna. Para mais detalhes, veja Sempre Encriptado. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlColumnEncryptionCngProvider |
A implementação do fornecedor da loja CMK para usar a API Microsoft Cryptography: Next Generation (CNG) com Always Encrypted. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlColumnEncryptionCspProvider |
A implementação do fornecedor da loja CMK para usar Microsoft Provedores de Serviços Criptográficos (CSP) baseados em CAPI com Sempre Encriptado. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlColumnEncryptionEnclaveProvider |
A classe base que define a interface para fornecedores de enclave para o Always Encrypted. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlColumnEncryptionKeyStoreProvider |
Classe base para todos os fornecedores principais de loja. Um fornecedor personalizado deve derivar desta classe e sobrescrever as suas funções membros, para depois registar o serviço usando SqlConnection.RegisterColumnEncryptionKeyStoreProviders(). Para mais detalhes, veja Always Encrypted. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlCommand |
Representa uma instrução Transact-SQL ou procedimento armazenado para executar contra uma base de dados SQL Server. Esta classe não pode ser herdada. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlCommandBuilder |
Gera automaticamente comandos de tabela única que são usados para reconciliar alterações feitas a um DataSet com a base de dados de SQL Server associada. Esta classe não pode ser herdada. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlConnection |
Representa uma ligação a uma base de dados do SQL Server. Esta classe não pode ser herdada. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlConnectionStringBuilder |
Fornece uma forma simples de criar e gerir o conteúdo das strings de ligação usadas pela SqlConnection classe. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlCredential |
SqlCredential fornece uma forma mais segura de especificar a palavra-passe para uma tentativa de login usando SQL Server Autenticação. SqlCredential é composto por um ID de utilizador e uma palavra-passe que será usada para SQL Server Autenticação. A palavra-passe num SqlCredential objeto é do tipo SecureString. SqlCredential não pode ser herdado. Windows Autenticação ( Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlDataAdapter |
Representa um conjunto de comandos de dados e uma ligação à base de dados que são usados para preencher o DataSet e atualizar uma base de dados SQL Server. Esta classe não pode ser herdada. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlDataReader |
Fornece uma forma de ler um fluxo apenas direto de linhas a partir de uma base de dados do SQL Server. Esta classe não pode ser herdada. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SQLDebugging |
Incluído para suportar aplicações de depuração. Não destinado ao uso direto. Esta API suporta depuração legada do .NET Framework e não é destinada ao uso direto. Para desenvolvimento de novas bases de dados, use a Microsoft. Data.SqlClient. |
| SqlDependency |
O objeto SqlDependency representa uma dependência de notificação de consulta entre uma aplicação e uma instância de SQL Server. Uma aplicação pode criar um SqlDependency objeto e registar-se para receber notificações através do gestor de OnChangeEventHandler eventos. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlEnclaveAttestationParameters |
Encapsula a informação que o SqlClient envia para o SQL Server para iniciar o processo de atestado e criação de uma sessão segura com o enclave que o SQL Server utiliza para cálculos em colunas protegidas com Always Encrypted. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlEnclaveSession |
Encapsula o estado de uma sessão segura entre o SqlClient e um enclave dentro do SQL Server, que pode ser usado para cálculos em colunas encriptadas protegidas com Always Encrypted. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlError |
Recolhe informações relevantes para um aviso ou erro devolvido pelo SQL Server. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlErrorCollection |
Recolhe todos os erros gerados pelo .NET Framework Data Provider para SQL Server. Esta classe não pode ser herdada. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlException |
A exceção que é lançada quando o SQL Server devolve um aviso ou erro. Esta classe não pode ser herdada. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlInfoMessageEventArgs |
Fornece dados para o InfoMessage evento. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlNotificationEventArgs |
Representa o conjunto de argumentos passados ao gestor de eventos de notificação. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlParameter |
Representa um parâmetro para a SqlCommand e opcionalmente o seu mapeamento para DataSet colunas. Esta classe não pode ser herdada. Para mais informações sobre parâmetros, consulte Configuração de Parâmetros e Tipos de Dados de Parâmetros. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlParameterCollection |
Representa uma coleção de parâmetros associados a a SqlCommand e respetivas correspondências para colunas em um DataSet. Esta classe não pode ser herdada. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlProviderServices |
A implementação do DbProviderServices para o fornecedor SqlClient para SQL Server. Mantenha esta API para o fornecedor integrado do .NET Framework Entity Framework. Para desenvolvimento de novas bases de dados, veja Microsoft. Data.SqlClient. |
| SqlRowsCopiedEventArgs |
Representa o conjunto de argumentos passados para o SqlRowsCopiedEventHandler. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlRowUpdatedEventArgs |
Fornece dados para o RowUpdated evento. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlRowUpdatingEventArgs |
Fornece dados para o RowUpdating evento. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlTransaction |
Representa uma transação Transact-SQL a ser feita numa base de dados SQL Server. Esta classe não pode ser herdada. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
Enumerações
| Nome | Descrição |
|---|---|
| ApplicationIntent |
Especifica um valor para ApplicationIntent. Os valores possíveis são Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| PoolBlockingPeriod |
Especifica um valor para a PoolBlockingPeriod propriedade. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SortOrder |
Especifica como as linhas de dados são ordenadas. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlAuthenticationMethod |
Descreve os diferentes métodos de autenticação SQL que podem ser usados por um cliente que se liga ao Base de Dados SQL do Azure. Para mais detalhes, veja Ligar à Base de Dados SQL Usando Autenticação Azure Active Directory. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlBulkCopyOptions |
flag bit a bit que especifica uma ou mais opções para usar com uma instância de SqlBulkCopy. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlCommandColumnEncryptionSetting |
Especifica como os dados serão enviados e recebidos ao ler e escrever colunas encriptadas. Dependendo da sua consulta específica, o impacto no desempenho pode ser reduzido ao contornar o processamento do driver Always Encrypted quando colunas não encriptadas estão a ser usadas. Note que estas definições não podem ser usadas para contornar a encriptação e obter acesso a dados de texto simples. Para mais detalhes, veja Always Encrypted (Database Engine). Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlConnectionColumnEncryptionSetting |
Especifica que a funcionalidade Always Encrypted está ativada numa ligação. Note que estas definições não podem ser usadas para contornar a encriptação e obter acesso a dados de texto simples. Para mais detalhes, veja Always Encrypted (Database Engine). Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlNotificationInfo |
Esta enumeração fornece informações adicionais sobre as diferentes notificações que podem ser recebidas pelo gestor de eventos de dependência. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlNotificationSource |
Indica a origem da notificação recebida pelo gestor de eventos de dependência. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlNotificationType |
Descreve os diferentes tipos de notificações que podem ser recebidos por um OnChangeEventHandler gestor de eventos através do SqlNotificationEventArgs parâmetro. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
Delegados
| Nome | Descrição |
|---|---|
| OnChangeEventHandler |
Trata do OnChange evento que é disparado quando é recebida uma notificação para qualquer um dos comandos associados a um SqlDependency objeto. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlInfoMessageEventHandler |
Representa o método que irá lidar com o InfoMessage evento de um SqlConnection. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlRowsCopiedEventHandler |
Representa o método que gere o SqlRowsCopied evento de um SqlBulkCopy. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlRowUpdatedEventHandler |
Representa o método que irá lidar com o RowUpdated evento de um SqlDataAdapter. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
| SqlRowUpdatingEventHandler |
Representa o método que irá lidar com o RowUpdating evento de um SqlDataAdapter. Para novos desenvolvimentos, use a Microsoft. Data.SqlClient. Esta página documenta o System.Data.SqlClient. |
Observações
Note
As System.Data.SqlClient APIs estão obsoletas. Para novos desenvolvimentos, use as APIs Microsoft.Data.SqlClient.
A .NET Data Provider para SQL Server descreve uma coleção de classes usadas para aceder a uma base de dados SQL Server no espaço gerido. Usando o SqlDataAdapter, pode preencher um residente DataSet de memória que pode usar para consultar e atualizar a base de dados.
Note
Para informações conceptuais sobre o uso deste namespace ao programar com .NET, veja SQL Server e ADO.NET.
