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 utilizzata per riempire e aggiornare l'origine DataSet dati.
public ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneablepublic ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable, System::Data::IDbDataAdapterpublic ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")]
public sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter, ICloneablepublic sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter, ICloneable, System.Data.IDbDataAdapterpublic sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter, ICloneablepublic sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")>]
type OleDbDataAdapter = class
inherit DbDataAdapter
interface IDataAdapter
interface IDbDataAdapter
interface ICloneabletype OleDbDataAdapter = class
inherit DbDataAdapter
interface IDbDataAdapter
interface IDataAdapter
interface ICloneabletype OleDbDataAdapter = class
inherit DbDataAdapter
interface IDataAdapter
interface IDbDataAdapter
interface ICloneablePublic NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Implements ICloneablePublic NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Implements ICloneable, IDbDataAdapterPublic NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter- Ereditarietà
- Attributi
- Implementazioni
Esempio
L'esempio seguente usa , OleDbCommandOleDbDataAdapter 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, 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
| 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 DataTableDbDataReaderda . (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 |
| SelectCommand |
Ottiene o imposta un'istruzione SQL o una stored procedure utilizzata per selezionare i record nell'origine dati. |
| Site |
Ottiene o imposta l'oggetto ISite dell'oggetto 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.
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 |
| 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 IDataReader specificatiDataTable. (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 DataTableIDbCommand 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 |
| 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 CommandBehavior ai valori specificati.DataTableSchemaType (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() |
Obsoleti.
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() |
Obsoleti.
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 |
| OnRowUpdating(RowUpdatingEventArgs) |
Genera l'evento |
| 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. |
