OleDbDataAdapter Classe
Definizione
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 usati per riempire l'oggetto DataSet e aggiornare l'origine dati.
public ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable
public ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable, System::Data::IDbDataAdapter
public ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter
public sealed class OleDbDataAdapter : 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
type OleDbDataAdapter = class
inherit DbDataAdapter
interface IDataAdapter
interface IDbDataAdapter
interface ICloneable
type OleDbDataAdapter = class
inherit DbDataAdapter
interface IDbDataAdapter
interface IDataAdapter
interface ICloneable
Public NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Implements ICloneable
Public NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Implements ICloneable, IDbDataAdapter
Public NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
- Ereditarietà
- Implementazioni
Esempio
L'esempio seguente usa , OleDbCommandOleDbDataAdapter e OleDbConnectionper selezionare i record da un'origine dati di Access e popolare un DataSet oggetto con le righe selezionate. Viene quindi restituito il riempimento DataSet . A tale scopo, il metodo viene passato a una stringa di connessione inizializzata DataSete 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. fornisce OleDbDataAdapter questo bridge usando Fill per caricare i dati dall'origine dati in DataSete usando Update per inviare le modifiche apportate di DataSet nuovo all'origine dati.
Quando riempie OleDbDataAdapter 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 DataSet, incluse le informazioni sulla chiave primaria, prima di compilarlo 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, l'oggetto OleDbDataAdapter non può 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, DeleteCommandUpdateCommand, 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
OleDbDataAdapter() |
Inizializza una nuova istanza della classe OleDbDataAdapter. |
OleDbDataAdapter(OleDbCommand) |
Inizializza una nuova istanza della classe OleDbDataAdapter con l'oggetto OleDbCommand specificato come la proprietà SelectCommand. |
OleDbDataAdapter(String, OleDbConnection) |
Inizializza una nuova istanza della classe OleDbDataAdapter con una proprietà SelectCommand. |
OleDbDataAdapter(String, String) |
Inizializza una nuova istanza della classe OleDbDataAdapter con una proprietà SelectCommand. |
Campi
DefaultSourceTableName |
Nome predefinito utilizzato dall'oggetto DataAdapter per i mapping di tabella. (Ereditato da DbDataAdapter) |
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'istruzione SQL o una stored procedure per eliminare i record dal DataSet. |
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. (Ereditato da DbDataAdapter) |
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'istruzione SQL o una stored procedure usata 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 |
SelectCommand |
Ottiene o imposta un'istruzione SQL o una stored procedure per selezionare 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. (Ereditato da DbDataAdapter) |
UpdateCommand |
Ottiene o imposta un'istruzione SQL o una stored procedure usata per aggiornare i record nell'origine dati. |
Metodi
AddToBatch(IDbCommand) |
Aggiunge un'interfaccia IDbCommand al batch corrente. (Ereditato da DbDataAdapter) |
ClearBatch() |
Rimuove tutti gli oggetti IDbCommand dal batch. (Ereditato da DbDataAdapter) |
CloneInternals() |
Obsoleti.
Obsoleti.
Obsoleti.
Obsoleti.
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. (Ereditato da DbDataAdapter) |
CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping) |
Inizializza una nuova istanza della classe RowUpdatingEventArgs. (Ereditato da DbDataAdapter) |
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. (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) |
Aggiunge o aggiorna righe nell'oggetto DataSet. (Ereditato da DbDataAdapter) |
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. (Ereditato da DbDataAdapter) |
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. (Ereditato da DbDataAdapter) |
Fill(DataSet, Object, String) |
Aggiunge o aggiorna righe nell'oggetto DataSet affinché corrispondano a quelle in un oggetto ADO |
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. (Ereditato da DbDataAdapter) |
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. (Ereditato da DbDataAdapter) |
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. (Ereditato da DbDataAdapter) |
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. (Ereditato da DbDataAdapter) |
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. (Ereditato da DbDataAdapter) |
Fill(DataTable, Object) |
Aggiunge o aggiorna righe in un oggetto DataTable affinché corrispondano a quelle in un oggetto ADO |
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. (Ereditato da DbDataAdapter) |
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. (Ereditato da DbDataAdapter) |
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. (Ereditato da DbDataAdapter) |
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. (Ereditato da DbDataAdapter) |
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. (Ereditato da DbDataAdapter) |
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. (Ereditato da DbDataAdapter) |
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. (Ereditato da DbDataAdapter) |
GetBatchedParameter(Int32, Int32) |
Restituisce un'interfaccia IDataParameter da uno dei comandi nel batch corrente. (Ereditato da DbDataAdapter) |
GetBatchedRecordsAffected(Int32, Int32, Exception) |
Restituisce informazioni su un tentativo di aggiornamento singolo all’interno di un aggiornamento in batch di dimensioni maggiori. (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() |
Obsoleti.
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. (Ereditato da DbDataAdapter) |
InitializeLifetimeService() |
Obsoleti.
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. (Ereditato da DbDataAdapter) |
OnRowUpdated(RowUpdatedEventArgs) |
Genera l'evento |
OnRowUpdating(RowUpdatingEventArgs) |
Genera l'evento |
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. (Ereditato da 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. (Ereditato da DbDataAdapter) |
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. (Ereditato da DbDataAdapter) |
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. (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 nell'oggetto DataSet con il nome DataTable specificato. (Ereditato da DbDataAdapter) |
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. (Ereditato da DbDataAdapter) |
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. (Ereditato da DbDataAdapter) |
RowUpdated |
Si verifica durante l'applicazione del metodo Update(DataSet) in seguito all'esecuzione di un comando nell'origine dati. Viene eseguito un tentativo di aggiornamento. Di conseguenza, si verifica l'evento. |
RowUpdating |
Si verifica durante l'applicazione del metodo Update(DataSet) prima che un comando sia eseguito nell'origine dati. Viene eseguito un tentativo di aggiornamento. Di conseguenza, si verifica l'evento. |
Implementazioni dell'interfaccia esplicita
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. |