DbDataAdapter Classe

Definizione

Supporta l'implementazione dell'interfaccia IDbDataAdapter. Gli eredi di DbDataAdapter implementano un set di funzioni per fornire una tipizzazione forte, ma ereditano la maggior parte delle funzionalità necessarie per implementare in modo completo un oggetto DataAdapter.

public ref class DbDataAdapter abstract : System::Data::Common::DataAdapter, ICloneable, System::Data::IDbDataAdapter
public ref class DbDataAdapter abstract : System::Data::Common::DataAdapter, ICloneable
public abstract class DbDataAdapter : System.Data.Common.DataAdapter, ICloneable, System.Data.IDbDataAdapter
public abstract class DbDataAdapter : System.Data.Common.DataAdapter, ICloneable
type DbDataAdapter = class
    inherit DataAdapter
    interface IDataAdapter
    interface IDbDataAdapter
    interface ICloneable
type DbDataAdapter = class
    inherit DataAdapter
    interface ICloneable
type DbDataAdapter = class
    inherit DataAdapter
    interface IDbDataAdapter
    interface IDataAdapter
    interface ICloneable
type DbDataAdapter = class
    inherit DataAdapter
    interface IDbDataAdapter
    interface ICloneable
    interface IDataAdapter
Public MustInherit Class DbDataAdapter
Inherits DataAdapter
Implements ICloneable, IDbDataAdapter
Public MustInherit Class DbDataAdapter
Inherits DataAdapter
Implements ICloneable
Ereditarietà
Derivato
Implementazioni

Commenti

La DbDataAdapter classe eredita dalla classe e implementa l'interfaccia DataAdapter IDbDataAdapter . Consente a una classe di implementare un DataAdapter progettato per l'uso con un database relazionale.

Un'applicazione non crea direttamente un'istanza della DbDataAdapter classe, ma crea un'istanza di una classe che eredita da essa.

Le classi che ereditano devono implementare DbDataAdapter i membri ereditati e in genere definiscono altri membri per aggiungere funzionalità specifiche del provider. Ad esempio, la DbDataAdapter classe definisce la SelectCommand proprietà e la DbDataAdapter classe definisce otto overload del Fill metodo. A sua volta, la OleDbDataAdapter classe eredita il Fill metodo e definisce anche due overload aggiuntivi di Fill che accettano un oggetto ADO Recordset come parametro.

Note per gli implementatori

Quando si eredita dalla DbDataAdapter classe, è consigliabile implementare i costruttori seguenti:

Elemento Descrizione
*Prv* DataAdapter() Inizializza una nuova istanza della classe *PrvDataAdapter*.
*Prv* DataAdapter(*PrvCommand* *selectCommand*) Inizializza una nuova istanza della classe *PrvDataAdapter* con l'istruzione SELECT specificata SQL.
*Prv* DataAdapter(string *selectCommandText*, string *selectConnectionString*) Inizializza una nuova istanza della classe *PrvDataAdapter* con un'istruzione SELECT SQL e una stringa di connessione.
*Prv* DataAdapter(string *selectCommandText*, *PrvConnection* *selectConnection*) Inizializza una nuova istanza della classe *PrvDataAdapter* con un'istruzione SELECT SQL e un oggetto *PrvConnection*.

Per promuovere la coerenza tra i provider di dati .NET Framework, è necessario assegnare un nome alla classe ereditata nel formato PrvDataAdapter, dove Prv è il prefisso uniforme assegnato a tutte le classi in uno spazio dei nomi specifico .NET Framework provider di dati. Ad esempio, "Sql" è il prefisso della SqlDataAdapter classe nello spazio dei nomi System.Data.SqlClient .

Costruttori

DbDataAdapter()

Inizializza una nuova istanza di una classe DataAdapter.

DbDataAdapter(DbDataAdapter)

Inizializza una nuova istanza della DataAdapter classe da un oggetto esistente dello stesso tipo.

Campi

DefaultSourceTableName

Nome predefinito utilizzato dall'oggetto DataAdapter per i mapping di tabella.

Proprietà

AcceptChangesDuringFill

Ottiene o imposta un valore che indica se il metodo AcceptChanges() viene chiamato per una classe DataRow dopo che questa è stata aggiunta alla classe DataTable, durante un'operazione del metodo Fill.

(Ereditato da DataAdapter)
AcceptChangesDuringUpdate

Ottiene o imposta se il metodo AcceptChanges() viene chiamato durante un metodo Update(DataSet).

(Ereditato da DataAdapter)
CanRaiseEvents

Ottiene un valore che indica se il componente può generare un evento.

(Ereditato da Component)
Container

Ottiene l'oggetto IContainer che contiene Component.

(Ereditato da Component)
ContinueUpdateOnError

Ottiene o imposta un valore che specifica se generare un'eccezione quando viene rilevato un errore durante l'aggiornamento di una riga.

(Ereditato da DataAdapter)
DeleteCommand

Ottiene o imposta un comando per l'eliminazione di record dal set di dati.

DesignMode

Ottiene un valore che indica se il Component si trova in modalità progettazione.

(Ereditato da Component)
Events

Ottiene l'elenco dei gestori eventi allegati a questo Component.

(Ereditato da Component)
FillCommandBehavior

Ottiene o imposta il comportamento del comando utilizzato per riempire l'adattatore dati.

FillLoadOption

Ottiene o imposta l'oggetto LoadOption che determina il modo in cui l'adattatore riempie l'oggetto DataTable dall'oggetto DbDataReader.

(Ereditato da DataAdapter)
InsertCommand

Ottiene o imposta un comando utilizzato per inserire nuovi record nell'origine dati.

MissingMappingAction

Determina l'operazione da eseguire quando per i dati in arrivo non è presente una tabella o una colonna corrispondente.

(Ereditato da DataAdapter)
MissingSchemaAction

Determina l'operazione da eseguire quando per lo schema DataSet esistente non esistono dati in arrivo corrispondenti.

(Ereditato da DataAdapter)
ReturnProviderSpecificTypes

Ottiene o imposta un valore che indica se il metodo Fill deve restituire valori specifici del provider o valori comuni conformi a CLS.

(Ereditato da DataAdapter)
SelectCommand

Ottiene o imposta un comando utilizzato per selezionare i record nell'origine dati.

Site

Ottiene o imposta l'oggetto ISite di Component.

(Ereditato da Component)
TableMappings

Ottiene una raccolta che fornisce il mapping primario tra una tabella di origine e un DataTableoggetto .

(Ereditato da DataAdapter)
UpdateBatchSize

Ottiene o imposta un valore che attiva o disabilita il supporto dell'elaborazione batch e specifica il numero di comandi che è possibile eseguire in un batch.

UpdateCommand

Ottiene o imposta un comando utilizzato per aggiornare i record nell'origine dati.

Metodi

AddToBatch(IDbCommand)

Aggiunge un'interfaccia IDbCommand al batch corrente.

ClearBatch()

Rimuove tutti gli oggetti IDbCommand dal batch.

CloneInternals()
Obsoleta.
Obsoleta.
Obsoleta.
Obsoleta.

Crea una copia di questa istanza di DataAdapter.

(Ereditato da DataAdapter)
CreateObjRef(Type)

Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto.

(Ereditato da MarshalByRefObject)
CreateRowUpdatedEvent(DataRow, IDbCommand, StatementType, DataTableMapping)

Inizializza una nuova istanza della classe RowUpdatedEventArgs.

CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping)

Inizializza una nuova istanza della classe RowUpdatingEventArgs.

CreateTableMappings()

Crea un nuovo oggetto DataTableMappingCollection.

(Ereditato da DataAdapter)
Dispose()

Rilascia tutte le risorse usate da Component.

(Ereditato da Component)
Dispose(Boolean)

Rilascia le risorse non gestite usate da DbDataAdapter e, facoltativamente, le risorse gestite.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
ExecuteBatch()

Esegue il batch corrente.

Fill(DataSet)

Aggiunge o aggiorna righe nell'oggetto DataSet.

Fill(DataSet, Int32, Int32, String)

Aggiunge o aggiorna righe in un intervallo specificato nell'oggetto DataSet affinché corrispondano a quelle nell'origine dati mediante DataSet e i nomi di DataTable.

Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior)

Aggiunge o aggiorna righe in un intervallo specificato nell'oggetto DataSet affinché corrispondano a quelle nell'origine dati utilizzando i nomi, la stringa di comando e le funzioni di comando dell'oggetto DataSet e della tabella di origine.

Fill(DataSet, String)

Aggiunge o aggiorna righe in un oggetto DataSet affinché corrispondano a quelle nell'origine dati mediante l'oggetto DataSet e i relativi nomi DataTable.

Fill(DataSet, String, IDataReader, Int32, Int32)

Aggiunge o aggiorna righe in un intervallo specificato nell'oggetto DataSet affinché corrispondano a quelle nell'origine dati usando i nomi DataSet, DataTable e IDataReader.

Fill(DataSet, String, IDataReader, Int32, Int32)

Aggiunge o aggiorna righe in un intervallo specificato nell'oggetto DataSet affinché corrispondano a quelle nell'origine dati mediante DataSet e i nomi di DataTable.

(Ereditato da DataAdapter)
Fill(DataTable)

Aggiunge o aggiorna righe in un intervallo specificato nell'oggetto DataSet affinché corrispondano a quelle nell'origine dati mediante il nome di DataTable.

Fill(DataTable, IDataReader)

Aggiunge o aggiorna righe in un oggetto DataTable affinché corrispondano a quelle dell'origine dati, usando i nomi DataTable e IDataReader specificati.

Fill(DataTable, IDataReader)

Aggiunge o aggiorna righe nell'oggetto DataTable affinché corrispondano a quelle dell'origine dati, utilizzando il nome di DataTable e l'oggetto IDataReader specificato.

(Ereditato da DataAdapter)
Fill(DataTable, IDbCommand, CommandBehavior)

Aggiunge o aggiorna righe in un oggetto DataTable affinché corrispondano a quelle dell'origine dati, utilizzando gli oggetti DataTable, IDbCommand e CommandBehavior specificati.

Fill(DataTable[], IDataReader, Int32, Int32)

Aggiunge o aggiorna righe in un intervallo specificato nell'insieme di oggetti DataTable affinché corrispondano a quelle nell'origine dati.

(Ereditato da DataAdapter)
Fill(DataTable[], Int32, Int32, IDbCommand, CommandBehavior)

Aggiunge o aggiorna righe in un intervallo specificato nell'oggetto DataSet affinché corrispondano a quelle nell'origine dati mediante DataSet e i nomi di DataTable.

Fill(Int32, Int32, DataTable[])

Aggiunge o aggiorna righe in uno o più DataTable oggetti per corrispondere a quelli nell'origine dati a partire dal record specificato e recuperando fino al numero massimo di record specificato.

FillSchema(DataSet, SchemaType)

Aggiunge un oggetto DataTable denominato "Table" all'oggetto DataSet specificato e configura lo schema perché corrisponda a quello presente nell'origine dati basato sull'oggetto SchemaType specificato.

FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior)

Aggiunge un oggetto DataTable all'oggetto DataSet specificato e di configurare lo schema in modo che corrisponda a quello dell'origine dati basato sull'oggetto SchemaType specificato.

FillSchema(DataSet, SchemaType, String)

Aggiunge un oggetto DataTable all'oggetto DataSet specificato e configura lo schema in modo che corrisponda a quello dell'origine dati in base a SchemaType e DataTable.

FillSchema(DataSet, SchemaType, String, IDataReader)

Aggiunge una classe DataTable alla classe DataSet specificata.

(Ereditato da DataAdapter)
FillSchema(DataTable, SchemaType)

Configura lo schema dell'oggetto DataTable specificato in base all'oggetto SchemaType specificato.

FillSchema(DataTable, SchemaType, IDataReader)

Aggiunge una classe DataTable alla classe DataSet specificata.

(Ereditato da DataAdapter)
FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior)

Configura lo schema dell'oggetto DataTable specificato, una stringa di comando SchemaType e valori di CommandBehavior.

GetBatchedParameter(Int32, Int32)

Restituisce un'interfaccia IDataParameter da uno dei comandi nel batch corrente.

GetBatchedRecordsAffected(Int32, Int32, Exception)

Restituisce informazioni su un tentativo di aggiornamento singolo all’interno di un aggiornamento in batch di dimensioni maggiori.

GetFillParameters()

Ottiene i parametri impostati dall'utente durante l'esecuzione di un'istruzione SQL SELECT.

GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetLifetimeService()
Obsoleta.

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.

(Ereditato da MarshalByRefObject)
GetService(Type)

Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container.

(Ereditato da Component)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
HasTableMappings()

Indica se è stata creata una classe DataTableMappingCollection.

(Ereditato da DataAdapter)
InitializeBatching()

Inizializza i batch per la classe DbDataAdapter.

InitializeLifetimeService()
Obsoleta.

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.

(Ereditato da MarshalByRefObject)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
MemberwiseClone(Boolean)

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.

(Ereditato da MarshalByRefObject)
OnFillError(FillErrorEventArgs)

Genera l'evento FillError.

OnFillError(FillErrorEventArgs)

Richiamato quando si verifica un errore durante l'utilizzo del metodo Fill.

(Ereditato da DataAdapter)
OnRowUpdated(RowUpdatedEventArgs)

Genera l'evento RowUpdated di un provider di dati .NET.

OnRowUpdating(RowUpdatingEventArgs)

Genera l'evento RowUpdating di un provider di dati .NET.

ResetFillLoadOption()

Reimposta la proprietà FillLoadOption allo stato predefinito e fa in modo che il metodo Fill(DataSet) rispetti la proprietà AcceptChangesDuringFill.

(Ereditato da DataAdapter)
ShouldSerializeAcceptChangesDuringFill()

Determina se la proprietà AcceptChangesDuringFill deve essere mantenuta.

(Ereditato da DataAdapter)
ShouldSerializeFillLoadOption()

Determina se la proprietà FillLoadOption deve essere mantenuta.

(Ereditato da DataAdapter)
ShouldSerializeTableMappings()

Determina se sono presenti più oggetti DataTableMapping e se è necessario conservarli.

(Ereditato da DataAdapter)
TerminateBatching()

Termina l'operazione in batch per la classe DbDataAdapter.

ToString()

Restituisce un oggetto String che contiene il nome dell'eventuale oggetto Component. Questo metodo non deve essere sottoposto a override.

(Ereditato da Component)
Update(DataRow[])

Aggiorna il valore nel database eseguendo le rispettive istruzioni INSERT, UPDATE o DELETE per ciascuna riga inserita, aggiornata o eliminata nella matrice specificata nell'oggetto DataSet.

Update(DataRow[], DataTableMapping)

Aggiorna i valore nel database eseguendo le rispettive istruzioni INSERT, UPDATE o DELETE per ciascuna riga inserita, aggiornata o eliminata nella matrice specificata degli oggetti DataRow.

Update(DataSet)

Aggiorna il valore nel database eseguendo le rispettive istruzioni INSERT, UPDATE o DELETE per ciascuna riga inserita, aggiornata o eliminata nell'oggetto DataSet specificato.

Update(DataSet, String)

Aggiorna i valori nel database eseguendo le rispettive istruzioni INSERT, UPDATE o DELETE per ogni riga inserita, aggiornata o eliminata nell'oggetto DataSet con il nome DataTable specificato.

Update(DataTable)

Aggiorna il valore nel database eseguendo le rispettive istruzioni INSERT, UPDATE o DELETE per ciascuna riga inserita, aggiornata o eliminata nell'oggetto DataTable specificato.

Eventi

Disposed

Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose().

(Ereditato da Component)
FillError

Restituito quando si verifica un errore durante un'operazione di riempimento.

FillError

Restituito quando si verifica un errore durante un'operazione di riempimento.

(Ereditato da DataAdapter)

Implementazioni dell'interfaccia esplicita

ICloneable.Clone()
Obsoleta.

Crea un nuovo oggetto che è una copia dell'istanza corrente.

IDataAdapter.TableMappings

Ottiene una raccolta che indica come viene eseguito il mapping di una tabella di origine a una tabella del set di dati.

(Ereditato da DataAdapter)
IDbDataAdapter.DeleteCommand

Ottiene o imposta un'istruzione SQL per l'eliminazione di record dal set di dati.

IDbDataAdapter.InsertCommand

Ottiene o imposta un'istruzione SQL utilizzata per inserire nuovi record nell'origine dati.

IDbDataAdapter.SelectCommand

Ottiene o imposta un'istruzione SQL utilizzata per selezionare i record nell'origine dati.

IDbDataAdapter.UpdateCommand

Ottiene o imposta un'istruzione SQL utilizzata per aggiornare i record nell'origine dati.

Si applica a

Vedi anche