OleDbDataAdapter Classe

Definizione

Spazio dei nomi:: System.Data.OleDb

Assembly:: System.Data.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Rappresenta un set di comandi dati e una connessione di database utilizzata per riempire e aggiornare l'origine DataSet dati.

public ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable, System::Data::IDbDataAdapter

public ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable

public sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter, ICloneable, System.Data.IDbDataAdapter

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

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

Public NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Implements ICloneable, IDbDataAdapter

Public NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Implements ICloneable

Ereditarietà: Object

MarshalByRefObject

Component

DataAdapter

DbDataAdapter
OleDbDataAdapter

Implementazioni: IDataAdapter IDbDataAdapter ICloneable

Esempio

L'esempio seguente usa , OleDbCommand OleDbDataAdapter e OleDbConnectionper selezionare i record da un'origine dati di Access e popolare un oggetto DataSet con le righe selezionate. Viene quindi restituito il riempimento DataSet . A tale scopo, il metodo viene passato a un oggetto inizializzato DataSet, a una stringa di connessione e a una stringa di query che è un'istruzione SQL SELECT.

public static OleDbDataAdapter CreateDataAdapter(string selectCommand,
    OleDbConnection connection)
{
    OleDbDataAdapter adapter = new OleDbDataAdapter(selectCommand, connection);

    adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey;

    // Create the Insert, Update and Delete commands.
    adapter.InsertCommand = new OleDbCommand(
        "INSERT INTO Customers (CustomerID, CompanyName) " +
        "VALUES (?, ?)");

    adapter.UpdateCommand = new OleDbCommand(
        "UPDATE Customers SET CustomerID = ?, CompanyName = ? " +
        "WHERE CustomerID = ?");

    adapter.DeleteCommand = new OleDbCommand(
        "DELETE FROM Customers WHERE CustomerID = ?");

    // Create the parameters.
    adapter.InsertCommand.Parameters.Add("@CustomerID",
        OleDbType.Char, 5, "CustomerID");
    adapter.InsertCommand.Parameters.Add("@CompanyName",
        OleDbType.VarChar, 40, "CompanyName");

    adapter.UpdateCommand.Parameters.Add("@CustomerID",
        OleDbType.Char, 5, "CustomerID");
    adapter.UpdateCommand.Parameters.Add("@CompanyName",
        OleDbType.VarChar, 40, "CompanyName");
    adapter.UpdateCommand.Parameters.Add("@oldCustomerID",
        OleDbType.Char, 5, "CustomerID").SourceVersion =
        DataRowVersion.Original;

    adapter.DeleteCommand.Parameters.Add("@CustomerID",
        OleDbType.Char, 5, "CustomerID").SourceVersion =
        DataRowVersion.Original;

    return adapter;
}

Public Function CreateDataAdapter(ByVal selectCommand As String, _
    ByVal connection As OleDbConnection) As OleDbDataAdapter

    Dim adapter As OleDbDataAdapter = _
        New OleDbDataAdapter(selectCommand, connection)

    adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey

    ' Create the commands.
    adapter.InsertCommand = New OleDbCommand( _
        "INSERT INTO Customers (CustomerID, CompanyName) " & _
         "VALUES (?, ?)")

    adapter.UpdateCommand = New OleDbCommand( _
        "UPDATE Customers SET CustomerID = ?, CompanyName = ? " & _
        "WHERE CustomerID = ?")

    adapter.DeleteCommand = New OleDbCommand( _
        "DELETE FROM Customers WHERE CustomerID = ?")

    ' Create the parameters.
    adapter.InsertCommand.Parameters.Add( _
        "@CustomerID", OleDbType.Char, 5, "CustomerID")
    adapter.InsertCommand.Parameters.Add( _
        "@CompanyName", OleDbType.VarChar, 40, "CompanyName")

    adapter.UpdateCommand.Parameters.Add( _
        "@CustomerID", OleDbType.Char, 5, "CustomerID")
    adapter.UpdateCommand.Parameters.Add( _
        "@CompanyName", OleDbType.VarChar, 40, "CompanyName")
    adapter.UpdateCommand.Parameters.Add( _
        "@oldCustomerID", OleDbType.Char, 5, "CustomerID").SourceVersion = _
        DataRowVersion.Original

    adapter.DeleteCommand.Parameters.Add( _
        "@CustomerID", OleDbType.Char, 5, "CustomerID").SourceVersion = _
        DataRowVersion.Original

    Return adapter
End Function

Commenti

funge OleDbDataAdapter da ponte tra un'origine DataSet dati e per il recupero e il salvataggio dei dati. OleDbDataAdapter fornisce questo bridge usando Fill per caricare i dati dall'origine dati in DataSete usando Update per inviare le modifiche apportate DataSet di nuovo all'origine dati.

OleDbDataAdapter Quando riempie un DataSetoggetto , creerà le tabelle e le colonne appropriate per i dati restituiti, se non esistono già. Tuttavia, le informazioni sulla chiave primaria non vengono incluse nello schema creato in modo implicito, a meno che la MissingSchemaAction proprietà non sia impostata su AddWithKey. È anche possibile creare lo OleDbDataAdapter schema di , incluse le informazioni sulla chiave primaria, prima di DataSetcompilarlo con i dati usando FillSchema. Per altre informazioni, vedere Aggiunta di vincoli esistenti a un set di dati.

Si noti che alcuni provider OLE DB, incluso il provider MSDataShape, non restituiscono informazioni sulla tabella di base o sulla chiave primaria. Pertanto, non OleDbDataAdapter è possibile impostare correttamente la PrimaryKey proprietà in alcun oggetto creato DataTable. In questi casi è necessario specificare in modo esplicito le chiavi primarie per le tabelle in DataSet.

Include OleDbDataAdapter anche le SelectCommandproprietà , InsertCommand, DeleteCommand UpdateCommand, e TableMappings per facilitare il caricamento e l'aggiornamento dei dati.

Quando si crea un'istanza di OleDbDataAdapter, le proprietà vengono impostate su valori iniziali. Per un elenco di questi valori, vedere il OleDbDataAdapter costruttore.

Costruttori

Nome	Descrizione
OleDbDataAdapter()	Inizializza una nuova istanza della classe OleDbDataAdapter.
OleDbDataAdapter(OleDbCommand)	Inizializza una nuova istanza della OleDbDataAdapter classe con l'oggetto specificato OleDbCommand come SelectCommand proprietà .
OleDbDataAdapter(String, OleDbConnection)	Inizializza una nuova istanza della OleDbDataAdapter classe con un oggetto SelectCommand.
OleDbDataAdapter(String, String)	Inizializza una nuova istanza della OleDbDataAdapter classe con un oggetto SelectCommand.

Campi

Nome	Descrizione
DefaultSourceTableName	Nome predefinito utilizzato dall'oggetto DataAdapter per i mapping delle tabelle. (Ereditato da DbDataAdapter)

Proprietà

Nome	Descrizione
AcceptChangesDuringFill	Ottiene o imposta un valore che indica se AcceptChanges() viene chiamato su un DataRow oggetto dopo l'aggiunta DataTable a durante una delle operazioni Fill . (Ereditato da DataAdapter)
AcceptChangesDuringUpdate	Ottiene o imposta un valore che indica se AcceptChanges() viene chiamato durante un oggetto 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 contenente l'oggetto Component. (Ereditato da Component)
ContinueUpdateOnError	Ottiene o imposta un valore che specifica se generare un'eccezione quando si verifica un errore durante un aggiornamento di riga. (Ereditato da DataAdapter)
DeleteCommand	Ottiene o imposta un'istruzione SQL o una stored procedure per l'eliminazione di record dal set di dati.
DesignMode	Ottiene un valore che indica se è Component attualmente in modalità progettazione. (Ereditato da Component)
Events	Ottiene l'elenco dei gestori eventi associati a questo Componentoggetto . (Ereditato da Component)
FillCommandBehavior	Ottiene o imposta il comportamento del comando utilizzato per riempire l'adattatore dati. (Ereditato da DbDataAdapter)
FillLoadOption	Ottiene o imposta l'oggetto LoadOption che determina il modo in cui l'adattatore riempie l'oggetto DataTable DbDataReaderda . (Ereditato da DataAdapter)
InsertCommand	Ottiene o imposta un'istruzione SQL o una stored procedure utilizzata per inserire nuovi record nell'origine dati.
MissingMappingAction	Determina l'azione da eseguire quando i dati in ingresso non hanno una tabella o una colonna corrispondente. (Ereditato da DataAdapter)
MissingSchemaAction	Determina l'azione da eseguire quando lo schema esistente DataSet non corrisponde ai dati in ingresso. (Ereditato da DataAdapter)
ReturnProviderSpecificTypes	Ottiene o imposta un valore che indica se il metodo deve restituire valori specifici del `Fill` provider o valori comuni conformi a CLS. (Ereditato da DataAdapter)
SelectCommand	Ottiene o imposta un'istruzione SQL o una stored procedure utilizzata per selezionare i record nell'origine dati.
Site	Ottiene o imposta il ISite del Component. (Ereditato da Component)
TableMappings	Ottiene una raccolta che fornisce il mapping primario tra una tabella di origine e un oggetto DataTable. (Ereditato da DataAdapter)
UpdateBatchSize	Ottiene o imposta un valore che abilita o disabilita il supporto per l'elaborazione batch e specifica il numero di comandi che è possibile eseguire in un batch. (Ereditato da DbDataAdapter)
UpdateCommand	Ottiene o imposta un'istruzione SQL o una stored procedure utilizzata per aggiornare i record nell'origine dati.

Metodi

Nome	Descrizione
AddToBatch(IDbCommand)	Aggiunge un oggetto IDbCommand al batch corrente. (Ereditato da DbDataAdapter)
ClearBatch()	Rimuove tutti gli IDbCommand oggetti dal batch. (Ereditato da DbDataAdapter)
CloneInternals()	Obsoleti. Obsoleti. Obsoleti. Crea una copia di questa istanza di DataAdapter. (Ereditato da DataAdapter)
CreateObjRef(Type)	Crea un oggetto che contiene tutte le informazioni pertinenti necessarie per generare un proxy utilizzato per comunicare con un oggetto remoto. (Ereditato da MarshalByRefObject)
CreateRowUpdatedEvent(DataRow, IDbCommand, StatementType, DataTableMapping)	Inizializza una nuova istanza della classe RowUpdatedEventArgs. (Ereditato da DbDataAdapter)
CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping)	Inizializza una nuova istanza della classe RowUpdatingEventArgs. (Ereditato da DbDataAdapter)
CreateTableMappings()	Crea un nuovo DataTableMappingCollectionoggetto . (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, rilascia le risorse gestite. (Ereditato da DbDataAdapter)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
ExecuteBatch()	Esegue il batch corrente. (Ereditato da DbDataAdapter)
Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior)	Aggiunge o aggiorna righe in un intervallo specificato nell'oggetto DataSet in modo che corrispondano a quelle nell'origine dati usando i DataSet nomi delle tabelle di origine e, la stringa di comando e il comportamento del comando. (Ereditato da DbDataAdapter)
Fill(DataSet, Int32, Int32, String)	Aggiunge o aggiorna righe in un intervallo specificato nell'oggetto DataSet in modo che corrispondano a quelle nell'origine dati usando i DataSet nomi e DataTable . (Ereditato da DbDataAdapter)
Fill(DataSet, Object, String)	Aggiunge o aggiorna righe nell'oggetto DataSet in modo che corrispondano a quelle in un oggetto ADO `Recordset` o `Record` utilizzando il nome specificato, l'oggetto ADO e il DataSetnome della tabella di origine.
Fill(DataSet, String, IDataReader, Int32, Int32)	Aggiunge o aggiorna righe in un intervallo specificato nell'oggetto DataSet in modo che corrispondano a quelle nell'origine dati usando i DataSetnomi , DataTablee IDataReader . (Ereditato da DbDataAdapter)
Fill(DataSet, String)	Aggiunge o aggiorna righe nell'oggetto DataSet in modo che corrispondano a quelle nell'origine dati usando i DataSet nomi e DataTable . (Ereditato da DbDataAdapter)
Fill(DataSet)	Aggiunge o aggiorna righe in DataSet. (Ereditato da DbDataAdapter)
Fill(DataTable, IDataReader)	Aggiunge o aggiorna righe in un DataTable oggetto in modo che corrispondano a quelle nell'origine dati usando i nomi e DataTable specificatiIDataReader. (Ereditato da DbDataAdapter)
Fill(DataTable, IDbCommand, CommandBehavior)	Aggiunge o aggiorna righe in un DataTable oggetto in modo che corrispondano a quelle nell'origine dati usando l'oggetto specificato DataTable IDbCommand e CommandBehavior. (Ereditato da DbDataAdapter)
Fill(DataTable, Object)	Aggiunge o aggiorna righe in un oggetto DataTable in modo che corrispondano a quelle in un oggetto ADO `Recordset` o `Record` utilizzando gli oggetti ADO specificati DataTable e ADO.
Fill(DataTable)	Aggiunge o aggiorna righe in un intervallo specificato nell'oggetto DataSet in modo che corrispondano a quelle nell'origine dati usando il DataTable nome. (Ereditato da DbDataAdapter)
Fill(DataTable[], IDataReader, Int32, Int32)	Aggiunge o aggiorna righe in un intervallo specificato nell'insieme di DataTable oggetti in modo che corrispondano a quelli nell'origine dati. (Ereditato da DataAdapter)
Fill(DataTable[], Int32, Int32, IDbCommand, CommandBehavior)	Aggiunge o aggiorna righe in un intervallo specificato nell'oggetto DataSet in modo che corrispondano a quelle nell'origine dati usando i DataSet nomi e DataTable . (Ereditato da DbDataAdapter)
Fill(Int32, Int32, DataTable[])	Aggiunge o aggiorna righe in uno o più DataTable oggetti in modo che corrispondano a quelli nell'origine dati a partire dal record specificato e recuperando fino al numero massimo di record specificato. (Ereditato da DbDataAdapter)
FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior)	Aggiunge un DataTable oggetto all'oggetto specificato DataSet e configura lo schema in modo che corrisponda a quello nell'origine dati in base all'oggetto specificato SchemaType. (Ereditato da DbDataAdapter)
FillSchema(DataSet, SchemaType, String, IDataReader)	Aggiunge un DataTable oggetto all'oggetto specificato DataSet. (Ereditato da DataAdapter)
FillSchema(DataSet, SchemaType, String)	Aggiunge un DataTable oggetto all'oggetto specificato DataSet e configura lo schema in modo che corrisponda a quello nell'origine dati in base all'oggetto specificato SchemaType e DataTable. (Ereditato da DbDataAdapter)
FillSchema(DataSet, SchemaType)	Aggiunge un DataTable oggetto denominato "Table" all'oggetto specificato DataSet e configura lo schema in modo che corrisponda a quello nell'origine dati in base all'oggetto specificato SchemaType. (Ereditato da DbDataAdapter)
FillSchema(DataTable, SchemaType, IDataReader)	Aggiunge un DataTable oggetto all'oggetto specificato DataSet. (Ereditato da DataAdapter)
FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior)	Configura lo schema dell'oggetto specificato in base alla stringa di comando e DataTable ai valori specificati.SchemaType CommandBehavior (Ereditato da DbDataAdapter)
FillSchema(DataTable, SchemaType)	Configura lo schema dell'oggetto specificato DataTable in base all'oggetto specificato SchemaType. (Ereditato da DbDataAdapter)
GetBatchedParameter(Int32, Int32)	Restituisce un oggetto IDataParameter da uno dei comandi nel batch corrente. (Ereditato da DbDataAdapter)
GetBatchedRecordsAffected(Int32, Int32, Exception)	Restituisce informazioni su un singolo tentativo di aggiornamento all'interno di un aggiornamento in batch più grande. (Ereditato da DbDataAdapter)
GetFillParameters()	Ottiene i parametri impostati dall'utente durante l'esecuzione di un'istruzione SQL SELECT. (Ereditato da DbDataAdapter)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetLifetimeService()	Recupera l'oggetto servizio di durata corrente che controlla i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
GetService(Type)	Restituisce un oggetto che rappresenta un servizio fornito da Component o da Container. (Ereditato da Component)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
HasTableMappings()	Indica se è stato creato un oggetto DataTableMappingCollection . (Ereditato da DataAdapter)
InitializeBatching()	Inizializza l'invio in batch per .DbDataAdapter (Ereditato da DbDataAdapter)
InitializeLifetimeService()	Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
MemberwiseClone(Boolean)	Crea una copia superficiale dell'oggetto corrente MarshalByRefObject . (Ereditato da MarshalByRefObject)
OnFillError(FillErrorEventArgs)	Genera l'evento FillError. (Ereditato da DbDataAdapter)
OnRowUpdated(RowUpdatedEventArgs)	Genera l'evento `RowUpdated` di un provider di dati .NET. (Ereditato da DbDataAdapter)
OnRowUpdating(RowUpdatingEventArgs)	Genera l'evento `RowUpdating` di un provider di dati .NET. (Ereditato da DbDataAdapter)
ResetFillLoadOption()	FillLoadOption Reimposta lo stato predefinito e causa l'onore Fill(DataSet)AcceptChangesDuringFilldi . (Ereditato da DataAdapter)
ShouldSerializeAcceptChangesDuringFill()	Determina se la AcceptChangesDuringFill proprietà deve essere persistente. (Ereditato da DataAdapter)
ShouldSerializeFillLoadOption()	Determina se la FillLoadOption proprietà deve essere persistente. (Ereditato da DataAdapter)
ShouldSerializeTableMappings()	Determina se uno o più DataTableMapping oggetti esistono e devono essere salvati in modo permanente. (Ereditato da DataAdapter)
TerminateBatching()	Termina l'invio in batch per l'oggetto DbDataAdapter. (Ereditato da DbDataAdapter)
ToString()	Restituisce un oggetto String contenente il nome dell'oggetto Component, se presente. Questo metodo non deve essere sottoposto a override. (Ereditato da Component)
Update(DataRow[], DataTableMapping)	Aggiorna i valori nel database eseguendo le rispettive istruzioni INSERT, UPDATE o DELETE per ogni riga inserita, aggiornata o eliminata nella matrice di DataRow oggetti specificata. (Ereditato da DbDataAdapter)
Update(DataRow[])	Aggiorna i valori nel database eseguendo le rispettive istruzioni INSERT, UPDATE o DELETE per ogni riga inserita, aggiornata o eliminata nella matrice specificata in DataSet. (Ereditato da DbDataAdapter)
Update(DataSet, String)	Aggiorna i valori nel database eseguendo le rispettive istruzioni INSERT, UPDATE o DELETE per ogni riga inserita, aggiornata o eliminata in DataSet con il nome specificato DataTable . (Ereditato da DbDataAdapter)
Update(DataSet)	Aggiorna i valori nel database eseguendo le rispettive istruzioni INSERT, UPDATE o DELETE per ogni riga inserita, aggiornata o eliminata nell'oggetto specificato DataSet. (Ereditato da DbDataAdapter)
Update(DataTable)	Aggiorna i valori nel database eseguendo le rispettive istruzioni INSERT, UPDATE o DELETE per ogni riga inserita, aggiornata o eliminata nell'oggetto specificato DataTable. (Ereditato da DbDataAdapter)

Eventi

Nome	Descrizione
Disposed	Si verifica quando il componente viene eliminato da una chiamata al Dispose() metodo . (Ereditato da Component)
FillError	Restituito quando si verifica un errore durante un'operazione di riempimento. (Ereditato da DbDataAdapter)
RowUpdated	Si verifica durante Update(DataSet) l'esecuzione di un comando sull'origine dati. Viene eseguito il tentativo di aggiornamento. Di conseguenza, l'evento si verifica.
RowUpdating	Si verifica durante Update(DataSet) la prima esecuzione di un comando sull'origine dati. Viene eseguito il tentativo di aggiornamento. Di conseguenza, l'evento si verifica.

Implementazioni dell'interfaccia esplicita

Nome	Descrizione
ICloneable.Clone()	Per una descrizione di questo membro, vedere Clone().
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	Per una descrizione di questo membro, vedere DeleteCommand.
IDbDataAdapter.InsertCommand	Per una descrizione di questo membro, vedere InsertCommand.
IDbDataAdapter.SelectCommand	Per una descrizione di questo membro, vedere SelectCommand.
IDbDataAdapter.UpdateCommand	Per una descrizione di questo membro, vedere UpdateCommand.

Si applica a

Vedi anche

DataAdapter e DataReader

Commenti e suggerimenti

Questa pagina è stata utile?