OdbcDataAdapter Classe

Definizione

Spazio dei nomi:

System.Data.Odbc

Assembly:

System.Data.Odbc.dll

Pacchetto:

System.Data.Odbc v9.0.0-rc.1.24431.7

Origine:

OdbcDataAdapter.cs

Rappresenta un set di comandi di dati e una connessione a un'origine dati utilizzata per riempire l'oggetto DataSet e aggiornare l'origine dati. La classe non può essere ereditata.

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

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

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

Public NotInheritable Class OdbcDataAdapter
Inherits DbDataAdapter
Implements ICloneable

Ereditarietà

Object

MarshalByRefObject

Component

DataAdapter

DbDataAdapter

OdbcDataAdapter

Implementazioni

IDataAdapter IDbDataAdapter ICloneable

Esempio

Nell'esempio seguente vengono OdbcCommandusati , OdbcDataAdaptere OdbcConnection per selezionare i record e popolare un DataSet oggetto con le righe selezionate.

public DataSet GetDataSetFromAdapter(
    DataSet dataSet, string connectionString, string queryString)
{
    using (OdbcConnection connection =
               new OdbcConnection(connectionString))
    {
        OdbcDataAdapter adapter =
            new OdbcDataAdapter(queryString, connection);

        // Open the connection and fill the DataSet.
        try
        {
            connection.Open();
            adapter.Fill(dataSet);
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        // The connection is automatically closed when the
        // code exits the using block.
    }
    return dataSet;
}

Public Function GetDataSetFromAdapter( _
    ByVal dataSet As DataSet, ByVal connectionString As String, _
    ByVal queryString As String) As DataSet

    Using connection As New OdbcConnection(connectionString)
        Dim adapter As New OdbcDataAdapter(queryString, connection)

        ' Open the connection and fill the DataSet.
        Try
            connection.Open()
            adapter.Fill(dataSet)
        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
        ' The connection is automatically closed when the
        ' code exits the Using block.
    End Using

    Return dataSet
End Function

Commenti

funge OdbcDataAdapter da ponte tra un'origine DataSet dati e per il recupero e il salvataggio dei dati. fornisce OdbcDataAdapter 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 OdbcDataAdapter un DataSetoggetto , crea le tabelle e le colonne necessarie 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 OdbcDataAdapter 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.

Nota

Quando si chiama il metodo su un'origine Fill dati che non dispone di una colonna chiave primaria, OdbcDataAdapter tenta di alzare di livello la colonna del vincolo univoco alla chiave primaria. Nel processo, contrassegna OdbcDataAdapter il vincolo univoco come non nullable. Questo comportamento funziona a meno che non sia presente un valore Null nella colonna del vincolo univoco. Se è presente un valore Null, il Fill metodo ha esito negativo con una violazione del vincolo. Per evitare questa situazione, non consentire valori Null nella colonna del vincolo univoco.

Nota

A causa delle limitazioni dei driver ODBC nativi, solo uno DataTable viene restituito quando si chiama FillSchema. Ciò vale anche quando si eseguono istruzioni batch SQL da cui sarebbero previsti più DataTable oggetti.

include OdbcDataAdapter anche le SelectCommandproprietà , InsertCommand, DeleteCommandUpdateCommand, e TableMappings per facilitare il caricamento e l'aggiornamento dei dati.

Costruttori

OdbcDataAdapter()	Inizializza una nuova istanza della classe OdbcDataAdapter.
OdbcDataAdapter(OdbcCommand)	Inizializza una nuova istanza della classe OdbcDataAdapter con l'istruzione SQL SELECT specificata.
OdbcDataAdapter(String, OdbcConnection)	Inizializza una nuova istanza della classe OdbcDataAdapter con un'istruzione SQL SELECT e una classe OdbcConnection.
OdbcDataAdapter(String, String)	Inizializza una nuova istanza della classe OdbcDataAdapter con un'istruzione SQL SELECT e una stringa di connessione.

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 record nell'origine 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. (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 Fill deve restituire valori specifici del provider o valori comuni conformi a CLS. (Ereditato da DataAdapter)
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. 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, 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[], 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 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()	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 un'operazione di aggiornamento in seguito all'esecuzione di un comando nell'origine dati.
RowUpdating	Si verifica durante l'applicazione del metodo Update(DataSet) prima che un comando sia eseguito nell'origine dati.

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.

Vedi anche

• DataAdapter e DataReader