SqlDataAdapter Classe

Definição

Namespace:

System.Data.SqlClient

Assembly:

System.Data.dll

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

public sealed class SqlDataAdapter : System.Data.Common.DbDataAdapter, ICloneable

type SqlDataAdapter = class
    inherit DbDataAdapter
    interface IDbDataAdapter
    interface IDataAdapter
    interface ICloneable

Public NotInheritable Class SqlDataAdapter
Inherits DbDataAdapter
Implements ICloneable

Herança

Object

MarshalByRefObject

Component

DataAdapter

DbDataAdapter

SqlDataAdapter

Implementações

IDataAdapter IDbDataAdapter ICloneable

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, Updateou Delete). Dependendo do tipo de alteração, o Insertmodelo de comando , Updateou 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, UpdateCommandou 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 Fill deve retornar valores específicos ao provedor ou valores comuns em conformidade com CLS. (Herdado de DataAdapter)
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.
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. 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()	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()	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 RowUpdated de um provedor de dados .NET. (Herdado de DbDataAdapter)
OnRowUpdating(RowUpdatingEventArgs)	Gera o evento RowUpdating de um provedor de dados .NET. (Herdado de DbDataAdapter)
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.

Confira também

• DataAdapters e DataReaders
• Manipulando dados (ADO.NET)
• Visão geral do ADO.NET