SqlDataAdapter Classe
Definição
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.
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 o banco de dados do SQL Server. Essa classe não pode ser herdada.
public ref class SqlDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable, System::Data::IDbDataAdapter
public ref class SqlDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable
public ref class SqlDataAdapter sealed : System::Data::Common::DbDataAdapter
public sealed class SqlDataAdapter : System.Data.Common.DbDataAdapter, ICloneable, System.Data.IDbDataAdapter
public sealed class SqlDataAdapter : System.Data.Common.DbDataAdapter, ICloneable
public sealed class SqlDataAdapter : System.Data.Common.DbDataAdapter
type SqlDataAdapter = class
inherit DbDataAdapter
interface IDbDataAdapter
interface IDataAdapter
interface ICloneable
Public NotInheritable Class SqlDataAdapter
Inherits DbDataAdapter
Implements ICloneable, IDbDataAdapter
Public NotInheritable Class SqlDataAdapter
Inherits DbDataAdapter
Implements ICloneable
Public NotInheritable Class SqlDataAdapter
Inherits DbDataAdapter
- Herança
- Implementações
Exemplos
O exemplo a seguir usa , SqlCommandSqlDataAdaptere SqlConnection para selecionar registros de um banco de dados e preencher um DataSet com as linhas selecionadas. Em seguida, o preenchido DataSet é retornado. Para fazer isso, o método é passado um inicializadoDataSet, um cadeia de conexão e uma cadeia de caracteres de consulta que é uma instrução SELECT Transact-SQL.
private static DataSet SelectRows(DataSet dataset,
string connectionString,string queryString)
{
using (SqlConnection connection =
new SqlConnection(connectionString))
{
SqlDataAdapter adapter = new SqlDataAdapter();
adapter.SelectCommand = new SqlCommand(
queryString, connection);
adapter.Fill(dataset);
return dataset;
}
}
Public Function SelectRows( _
ByVal dataSet As DataSet, ByVal connectionString As String, _
ByVal queryString As String) As DataSet
Using connection As New SqlConnection(connectionString)
Dim adapter As New SqlDataAdapter()
adapter.SelectCommand = New SqlCommand( _
queryString, connection)
adapter.Fill(dataSet)
Return dataSet
End Using
End Function
Comentários
O SqlDataAdapterserve como uma ponte entre um e SQL Server DataSet para recuperar e salvar dados. O SqlDataAdapter fornece essa ponte mapeando Fill, que altera os dados no DataSet para corresponder aos dados na fonte de dados e Update, que altera os dados na fonte de dados para corresponder aos dados no DataSet, usando as instruções Transact-SQL apropriadas em relação à fonte de dados. A atualização é executada por linha. Para cada linha inserida, modificada e excluída, o Update método determina o tipo de alteração que foi executada nela (Insert
, Update
ou Delete
). Dependendo do tipo de alteração, o Insert
modelo de comando , Update
ou Delete
é executado para propagar a linha modificada para a fonte de dados. Quando o SqlDataAdapter preenche um DataSet, ele cria as tabelas e colunas necessárias para os dados retornados se eles ainda não existirem. No entanto, as informações de chave primária não são incluídas no esquema criado implicitamente, a menos que a MissingSchemaAction propriedade esteja definida AddWithKeycomo . Você também pode ter a criação SqlDataAdapter do esquema do , incluindo informações de DataSetchave primária, antes de preenchê-lo com dados usando FillSchema
. Para obter mais informações, consulte Adicionando restrições existentes a um DataSet.
SqlDataAdapteré usado em conjunto com SqlConnection e SqlCommand para aumentar o desempenho ao se conectar a um banco de dados SQL Server.
Observação
Se você estiver usando procedimentos armazenados do SQL Server para editar ou excluir dados usando um DataAdapter
, não use SET NOCOUNT ON na definição do procedimento armazenado. Isso faz com que a contagem retornada de linhas afetadas seja zero, o que o DataAdapter
interpreta como um conflito de simultaneidade. Nesse caso, será gerada uma DBConcurrencyException.
O SqlDataAdapter também inclui as SelectCommandpropriedades , InsertCommand, DeleteCommand, UpdateCommande TableMappings para facilitar o carregamento e a atualização de dados.
Quando uma instância de é criada, as propriedades de SqlDataAdapter leitura/gravação são definidas como valores iniciais. Para obter uma lista desses valores, consulte o SqlDataAdapter construtor .
Os InsertCommand, DeleteCommande UpdateCommand são modelos genéricos que são preenchidos automaticamente com valores individuais de cada linha modificada por meio do mecanismo de parâmetros.
Para cada coluna propagada para a fonte de dados em Update, um parâmetro deve ser adicionado ao InsertCommand
, UpdateCommand
ou DeleteCommand
. A SourceColumn propriedade do DbParameter objeto deve ser definida como o nome da coluna. Essa configuração indica que o valor do parâmetro não está definido manualmente, mas é obtido da coluna específica na linha processada no momento.
Observação
Um InvalidOperationException ocorrerá se o Fill método for chamado e a tabela contiver um tipo definido pelo usuário que não esteja disponível no computador cliente. Para obter mais informações, veja Tipos CLR definidos pelo usuário.
Construtores
SqlDataAdapter() |
Inicializa uma nova instância da classe SqlDataAdapter. |
SqlDataAdapter(SqlCommand) |
Inicializa uma nova instância da classe SqlDataAdapter com o SqlCommand especificado como a propriedade SelectCommand. |
SqlDataAdapter(String, SqlConnection) |
Inicializa uma nova instância da classe SqlDataAdapter com um SelectCommand e um objeto SqlConnection. |
SqlDataAdapter(String, String) |
Inicializa uma nova instância da classe SqlDataAdapter com um SelectCommand e uma cadeia de conexão. |
Campos
DefaultSourceTableName |
O nome padrão usado pelo objeto DataAdapter para mapeamentos de tabela. (Herdado de DbDataAdapter) |
Propriedades
AcceptChangesDuringFill |
Obtém ou define um valor que indica se AcceptChanges() é chamado em um DataRow após ter sido adicionado ao DataTable durante alguma das operações de Preenchimento. (Herdado de DataAdapter) |
AcceptChangesDuringUpdate |
Obtém ou define se AcceptChanges() é chamado durante um Update(DataSet). (Herdado de DataAdapter) |
CanRaiseEvents |
Obtém um valor que indica se o componente pode acionar um evento. (Herdado de Component) |
Container |
Obtém o IContainer que contém o Component. (Herdado de Component) |
ContinueUpdateOnError |
Obtém ou define um valor que especifica se uma exceção deve ser gerada quando for encontrado um erro durante uma atualização de linha. (Herdado de DataAdapter) |
DeleteCommand |
Obtém ou define uma instrução Transact-SQL ou um procedimento armazenado para excluir registros na fonte de dados. |
DesignMode |
Obtém um valor que indica se o Component está no modo de design no momento. (Herdado de Component) |
Events |
Obtém a lista de manipuladores de eventos que estão anexados a este Component. (Herdado de Component) |
FillCommandBehavior |
Obtém ou define o comportamento do comando usado para preencher o adaptador de dados. (Herdado de DbDataAdapter) |
FillLoadOption |
Obtém ou define o LoadOption que determina como o adaptador preenche o DataTable do DbDataReader. (Herdado de DataAdapter) |
InsertCommand |
Obtém ou define uma instrução Transact-SQL ou um procedimento armazenado para inserir novos registros na fonte de dados. |
MissingMappingAction |
Determina a ação a ser tomada quando os dados de entrada não têm uma tabela ou coluna correspondente. (Herdado de DataAdapter) |
MissingSchemaAction |
Determina a ação a ser tomada quando o esquema DataSet existente não coincide com os dados de entrada. (Herdado de DataAdapter) |
ReturnProviderSpecificTypes |
Obtém ou define se o método |
SelectCommand |
Obtém ou define uma instrução Transact-SQL ou um procedimento armazenado usado para selecionar registros na fonte de dados. |
Site |
Obtém ou define o ISite do Component. (Herdado de Component) |
TableMappings |
Obtém uma coleção que fornece o mapeamento primário entre uma tabela de origem e um DataTable. (Herdado de DataAdapter) |
UpdateBatchSize |
Obtém ou define o número de linhas que são processadas em cada viagem de ida e volta ao servidor. |
UpdateBatchSize |
Obtém ou define um valor que habilita ou desabilita o suporte ao processamento de lote e especifica o número de comandos que podem ser executadas em um lote. (Herdado de DbDataAdapter) |
UpdateCommand |
Obtém ou define uma instrução Transact-SQL ou um procedimento armazenado usado para atualizar registros na fonte de dados. |
Métodos
AddToBatch(IDbCommand) |
Adiciona um IDbCommand ao lote atual. (Herdado de DbDataAdapter) |
ClearBatch() |
Remove todos os objetos IDbCommand do lote. (Herdado de DbDataAdapter) |
CloneInternals() |
Obsoleto.
Obsoleto.
Obsoleto.
Obsoleto.
Cria uma cópia dessa instância do DataAdapter. (Herdado de DataAdapter) |
CreateObjRef(Type) |
Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto. (Herdado de MarshalByRefObject) |
CreateRowUpdatedEvent(DataRow, IDbCommand, StatementType, DataTableMapping) |
Inicializa uma nova instância da classe RowUpdatedEventArgs. (Herdado de DbDataAdapter) |
CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping) |
Inicializa uma nova instância da classe RowUpdatingEventArgs. (Herdado de DbDataAdapter) |
CreateTableMappings() |
Cria um novo DataTableMappingCollection. (Herdado de DataAdapter) |
Dispose() |
Libera todos os recursos usados pelo Component. (Herdado de Component) |
Dispose(Boolean) |
Libera os recursos não gerenciados usados pelo DbDataAdapter e opcionalmente libera os recursos gerenciados. (Herdado de DbDataAdapter) |
Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
ExecuteBatch() |
Executa o lote atual. (Herdado de DbDataAdapter) |
Fill(DataSet) |
Adiciona ou atualiza linhas no DataSet. (Herdado de DbDataAdapter) |
Fill(DataSet, Int32, Int32, String) |
Adiciona ou atualiza linhas em um intervalo especificado no DataSet para corresponder àquelas na fonte de dados usando os nomes DataSet e DataTable. (Herdado de DbDataAdapter) |
Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior) |
Adiciona ou atualiza linhas em um intervalo especificado no DataSet para corresponder àquelas na fonte de dados usando o DataSet e nomes da tabela de origem, a cadeia de comando e o comportamento do comando. (Herdado de DbDataAdapter) |
Fill(DataSet, String) |
Adiciona ou atualiza linhas no DataSet para corresponder às existentes na fonte de dados usando os nomes DataSet e DataTable. (Herdado de DbDataAdapter) |
Fill(DataSet, String, IDataReader, Int32, Int32) |
Adiciona ou atualiza linhas em um intervalo especificado no DataSet para que correspondam àquelas na fonte de dados usando os nomes DataSet, DataTable e IDataReader. (Herdado de DbDataAdapter) |
Fill(DataTable) |
Adiciona ou atualiza linhas em um intervalo especificado no DataSet para corresponder àquelas na fonte de dados usando o nome DataTable. (Herdado de DbDataAdapter) |
Fill(DataTable, IDataReader) |
Adiciona ou atualiza linhas em uma DataTable para que correspondam àquelas na fonte de dados usando os nomes DataTable e IDataReader especificados. (Herdado de DbDataAdapter) |
Fill(DataTable, IDbCommand, CommandBehavior) |
Adiciona ou atualiza linhas em um DataTable para corresponder às existentes na fonte de dados usando o DataTable, IDbCommand e CommandBehavior especificados. (Herdado de DbDataAdapter) |
Fill(DataTable[], IDataReader, Int32, Int32) |
Adiciona ou atualiza as linhas em um intervalo especificado na coleção de objetos DataTable para corresponder àquelas na fonte de dados. (Herdado de DataAdapter) |
Fill(DataTable[], Int32, Int32, IDbCommand, CommandBehavior) |
Adiciona ou atualiza linhas em um intervalo especificado no DataSet para corresponder àquelas na fonte de dados usando os nomes DataSet e DataTable. (Herdado de DbDataAdapter) |
Fill(Int32, Int32, DataTable[]) |
Adiciona ou atualiza linhas em um ou mais DataTable objetos para corresponder às da fonte de dados começando no registro especificado e recuperando até o número máximo de registros especificado. (Herdado de DbDataAdapter) |
FillSchema(DataSet, SchemaType) |
Adiciona um DataTable com o nome “Tabela” ao DataSet especificado e configura o esquema para corresponder a eles na fonte de dados com base no SchemaType especificado. (Herdado de DbDataAdapter) |
FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior) |
Adiciona um DataTable ao DataSet especificado e configura o esquema para corresponder à fonte de dados com base no SchemaType especificado. (Herdado de DbDataAdapter) |
FillSchema(DataSet, SchemaType, String) |
Adiciona um DataTable ao DataSet especificado e configura o esquema para corresponder à fonte de dados com base nos SchemaType e DataTable especificados. (Herdado de DbDataAdapter) |
FillSchema(DataSet, SchemaType, String, IDataReader) |
Adiciona um DataTable ao DataSet especificado. (Herdado de DataAdapter) |
FillSchema(DataTable, SchemaType) |
Configura o esquema do DataTable especificado com base no SchemaType especificado. (Herdado de DbDataAdapter) |
FillSchema(DataTable, SchemaType, IDataReader) |
Adiciona um DataTable ao DataSet especificado. (Herdado de DataAdapter) |
FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior) |
Configura o esquema do DataTable especificado com base no SchemaType, na cadeia de caracteres de comando e nos valores CommandBehavior especificados. (Herdado de DbDataAdapter) |
GetBatchedParameter(Int32, Int32) |
Retorna um IDataParameter de um dos comandos no lote atual. (Herdado de DbDataAdapter) |
GetBatchedRecordsAffected(Int32, Int32, Exception) |
Retorna informações sobre uma tentativa de atualização individual dentro de uma atualização em lote maior. (Herdado de DbDataAdapter) |
GetFillParameters() |
Obtém os parâmetros definidos pelo usuário ao executar uma instrução SQL SELECT. (Herdado de DbDataAdapter) |
GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
GetLifetimeService() |
Obsoleto.
Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância. (Herdado de MarshalByRefObject) |
GetService(Type) |
Retorna um objeto que representa um serviço fornecido pelo Component ou pelo seu Container. (Herdado de Component) |
GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
HasTableMappings() |
Indica se um DataTableMappingCollection foi criado. (Herdado de DataAdapter) |
InitializeBatching() |
Inicializa o envio em lote para o DbDataAdapter. (Herdado de DbDataAdapter) |
InitializeLifetimeService() |
Obsoleto.
Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject) |
MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
MemberwiseClone(Boolean) |
Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject) |
OnFillError(FillErrorEventArgs) |
Aciona o evento FillError. (Herdado de DbDataAdapter) |
OnRowUpdated(RowUpdatedEventArgs) |
Gera o evento |
OnRowUpdating(RowUpdatingEventArgs) |
Gera o evento |
ResetFillLoadOption() |
Redefine FillLoadOption para seu estado padrão e faz com que Fill(DataSet) honre AcceptChangesDuringFill. (Herdado de DataAdapter) |
ShouldSerializeAcceptChangesDuringFill() |
Determina se a propriedade AcceptChangesDuringFill deve ser persistida. (Herdado de DataAdapter) |
ShouldSerializeFillLoadOption() |
Determina se a propriedade FillLoadOption deve ser persistida. (Herdado de DataAdapter) |
ShouldSerializeTableMappings() |
Determina se um ou mais objetos DataTableMapping existem e se devem ser persistidos. (Herdado de DataAdapter) |
TerminateBatching() |
Encerra o envio em lote para o DbDataAdapter. (Herdado de DbDataAdapter) |
ToString() |
Retorna um String que contém o nome do Component, se houver. Esse método não deve ser substituído. (Herdado de Component) |
Update(DataRow[]) |
Atualiza os valores no banco de dados executando as respectivas instruções INSERT, UPDATE ou DELETE para cada linha inserida, atualizada ou excluída na matriz especificada no DataSet. (Herdado de DbDataAdapter) |
Update(DataRow[], DataTableMapping) |
Atualiza os valores no banco de dados executando as respectivas instruções INSERT, UPDATE ou DELETE para cada linha inserida, atualizada ou excluída na matriz de objetos DataRow especificada. (Herdado de DbDataAdapter) |
Update(DataSet) |
Atualiza os valores no banco de dados executando as respectivas instruções INSERT, UPDATE ou DELETE para cada linha inserida, atualizada ou excluída no DataSet especificado. (Herdado de DbDataAdapter) |
Update(DataSet, String) |
Atualiza os valores no banco de dados executando as respectivas instruções INSERT, UPDATE ou DELETE para cada linha inserida, atualizada ou excluída no DataSet com o nome DataTable especificado. (Herdado de DbDataAdapter) |
Update(DataTable) |
Atualiza os valores no banco de dados executando as respectivas instruções INSERT, UPDATE ou DELETE para cada linha inserida, atualizada ou excluída no DataTable especificado. (Herdado de DbDataAdapter) |
Eventos
Disposed |
Ocorre quando o componente é disposto por uma chamada ao método Dispose(). (Herdado de Component) |
FillError |
É retornado quando ocorre um erro durante uma operação de preenchimento. (Herdado de DbDataAdapter) |
RowUpdated |
Ocorre durante o Update(DataSet), após um comando ser executado na fonte de dados. Realiza-se a tentativa de atualização, para que o evento seja acionado. |
RowUpdating |
Ocorre durante o Update(DataSet), após um comando ser executado com relação à fonte de dados. Realiza-se a tentativa de atualização, para que o evento seja acionado. |
Implantações explícitas de interface
ICloneable.Clone() |
Para obter uma descrição desse membro, confira Clone(). |
IDataAdapter.TableMappings |
Obtém uma coleção que indica como uma tabela de origem é mapeada para uma tabela de conjunto de dados. (Herdado de DataAdapter) |
IDbDataAdapter.DeleteCommand |
Para obter uma descrição desse membro, confira DeleteCommand. |
IDbDataAdapter.InsertCommand |
Para obter uma descrição desse membro, confira InsertCommand. |
IDbDataAdapter.SelectCommand |
Para obter uma descrição desse membro, confira SelectCommand. |
IDbDataAdapter.UpdateCommand |
Para obter uma descrição desse membro, confira UpdateCommand. |