OdbcDataAdapter Klasa

Definicja

Przestrzeń nazw:

System.Data.Odbc

Zestaw:

System.Data.Odbc.dll

Pakiet:

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

Źródło:

OdbcDataAdapter.cs

Reprezentuje zestaw poleceń danych i połączenie ze źródłem danych używanym do wypełniania DataSet i aktualizowania źródła danych. Klasa ta nie może być dziedziczona.

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

Dziedziczenie

Object

MarshalByRefObject

Component

DataAdapter

DbDataAdapter

OdbcDataAdapter

Implementuje

IDataAdapter IDbDataAdapter ICloneable

Przykłady

W poniższym przykładzie użyto OdbcCommandwartości , OdbcDataAdapteri OdbcConnection do wybrania rekordów i wypełnienia DataSet wartości wybranymi wierszami.

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

Uwagi

Element OdbcDataAdapter służy jako most między DataSet źródłem danych a i służącym do pobierania i zapisywania danych. Zapewnia OdbcDataAdapter ten most za pomocą funkcji Fill ładowania danych ze źródła danych do DataSetelementu i wysyłania Update zmian wprowadzonych z DataSet powrotem do źródła danych.

Po wypełnieniu OdbcDataAdapter elementu DataSetelement tworzy wymagane tabele i kolumny dla zwracanych danych, jeśli jeszcze nie istnieją. Jednak informacje o kluczu podstawowym nie są uwzględniane w niejawnie utworzonym schemacie, chyba że właściwość jest ustawiona MissingSchemaAction na AddWithKey. Być może masz OdbcDataAdapter również utworzony schemat DataSetelementu , w tym podstawowe informacje o kluczu, przed wypełnieniem go danymi przy użyciu polecenia FillSchema. Aby uzyskać więcej informacji, zobacz Dodawanie istniejących ograniczeń do zestawu danych.

Uwaga

Po wywołaniu Fill metody w źródle danych, które nie ma kolumny klucza podstawowego, OdbcDataAdapter próbuje podwyższyć poziom unikatowej kolumny ograniczenia do klucza podstawowego. W procesie oznacza OdbcDataAdapter unikatowe ograniczenie jako niepuste. To zachowanie działa, chyba że istnieje wartość null w unikatowej kolumnie ograniczenia. Jeśli istnieje wartość null, Fill metoda kończy się niepowodzeniem z naruszeniem ograniczeń. Aby uniknąć tej sytuacji, nie zezwalaj na wartości null w unikatowej kolumnie ograniczenia.

Uwaga

Ze względu na ograniczenia natywnych sterowników ODBC tylko jeden DataTable jest zawsze zwracany po wywołaniu .FillSchema Jest to prawdziwe nawet w przypadku wykonywania instrukcji wsadowych SQL, z których oczekiwano wielu DataTable obiektów.

Zawiera OdbcDataAdapter również SelectCommandwłaściwości , InsertCommand, , DeleteCommand, UpdateCommandi TableMappings w celu ułatwienia ładowania i aktualizowania danych.

Konstruktory

OdbcDataAdapter()	Inicjuje nowe wystąpienie klasy OdbcDataAdapter.
OdbcDataAdapter(OdbcCommand)	Inicjuje OdbcDataAdapter nowe wystąpienie klasy przy użyciu określonej instrukcji SQL SELECT.
OdbcDataAdapter(String, OdbcConnection)	Inicjuje OdbcDataAdapter nowe wystąpienie klasy za pomocą instrukcji SQL SELECT i .OdbcConnection
OdbcDataAdapter(String, String)	Inicjuje OdbcDataAdapter nowe wystąpienie klasy za pomocą instrukcji SQL SELECT i parametry połączenia.

Pola

DefaultSourceTableName

Domyślna nazwa używana przez DataAdapter obiekt dla mapowań tabel. (Odziedziczone po DbDataAdapter)

Właściwości

AcceptChangesDuringFill	Pobiera lub ustawia wartość wskazującąDataRow, czy AcceptChanges() jest wywoływana po dodaniu jej do DataTable dowolnego z operacji Wypełnianie. (Odziedziczone po DataAdapter)
AcceptChangesDuringUpdate	Pobiera lub ustawia, czy AcceptChanges() jest wywoływany podczas Update(DataSet). (Odziedziczone po DataAdapter)
CanRaiseEvents	Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie. (Odziedziczone po Component)
Container	Pobiera element IContainer zawierający element Component. (Odziedziczone po Component)
ContinueUpdateOnError	Pobiera lub ustawia wartość określającą, czy należy wygenerować wyjątek, gdy podczas aktualizacji wiersza wystąpi błąd. (Odziedziczone po DataAdapter)
DeleteCommand	Pobiera lub ustawia instrukcję SQL lub procedurę składowaną używaną do usuwania rekordów w źródle danych.
DesignMode	Pobiera wartość wskazującą, czy Component element jest obecnie w trybie projektowania. (Odziedziczone po Component)
Events	Pobiera listę programów obsługi zdarzeń dołączonych do tego Componentelementu . (Odziedziczone po Component)
FillCommandBehavior	Pobiera lub ustawia zachowanie polecenia użytego do wypełnienia karty danych. (Odziedziczone po DbDataAdapter)
FillLoadOption	Pobiera lub ustawia wartość LoadOption określającą sposób wypełnienia DataTable adaptera z elementu DbDataReader. (Odziedziczone po DataAdapter)
InsertCommand	Pobiera lub ustawia instrukcję SQL lub procedurę składowaną używaną do wstawiania nowych rekordów do źródła danych.
MissingMappingAction	Określa akcję do wykonania, gdy dane przychodzące nie mają pasującej tabeli ani kolumny. (Odziedziczone po DataAdapter)
MissingSchemaAction	Określa akcję do wykonania, gdy istniejący DataSet schemat nie jest zgodny z danymi przychodzącymi. (Odziedziczone po DataAdapter)
ReturnProviderSpecificTypes	Pobiera lub ustawia, czy Fill metoda powinna zwracać wartości specyficzne dla dostawcy, czy typowe wartości zgodne ze specyfikacją CLS. (Odziedziczone po DataAdapter)
SelectCommand	Pobiera lub ustawia instrukcję SQL lub procedurę składowaną używaną do wybierania rekordów w źródle danych.
Site	Pobiera lub ustawia ISite element .Component (Odziedziczone po Component)
TableMappings	Pobiera kolekcję, która udostępnia podstawowe mapowanie między tabelą źródłową a elementem DataTable. (Odziedziczone po DataAdapter)
UpdateBatchSize	Pobiera lub ustawia wartość, która włącza lub wyłącza obsługę przetwarzania wsadowego i określa liczbę poleceń, które można wykonać w partii. (Odziedziczone po DbDataAdapter)
UpdateCommand	Pobiera lub ustawia instrukcję SQL lub procedurę składowaną używaną do aktualizowania rekordów w źródle danych.

Metody

AddToBatch(IDbCommand)	Dodaje element do IDbCommand bieżącej partii. (Odziedziczone po DbDataAdapter)
ClearBatch()	Usuwa wszystkie IDbCommand obiekty z partii. (Odziedziczone po DbDataAdapter)
CloneInternals()	Przestarzałe. Tworzy kopię tego wystąpienia programu DataAdapter. (Odziedziczone po DataAdapter)
CreateObjRef(Type)	Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
CreateRowUpdatedEvent(DataRow, IDbCommand, StatementType, DataTableMapping)	Inicjuje nowe wystąpienie klasy RowUpdatedEventArgs. (Odziedziczone po DbDataAdapter)
CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping)	Inicjuje nowe wystąpienie klasy RowUpdatingEventArgs. (Odziedziczone po DbDataAdapter)
CreateTableMappings()	Tworzy nowy adres DataTableMappingCollection. (Odziedziczone po DataAdapter)
Dispose()	Zwalnia wszelkie zasoby używane przez element Component. (Odziedziczone po Component)
Dispose(Boolean)	Zwalnia zasoby niezarządzane używane przez element DbDataAdapter i opcjonalnie zwalnia zasoby zarządzane. (Odziedziczone po DbDataAdapter)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
ExecuteBatch()	Wykonuje bieżącą partię. (Odziedziczone po DbDataAdapter)
Fill(DataSet)	Dodaje lub odświeża wiersze w obiekcie DataSet. (Odziedziczone po DbDataAdapter)
Fill(DataSet, Int32, Int32, String)	Dodaje lub odświeża wiersze w określonym zakresie w DataSet celu dopasowania ich do tych w źródle danych przy użyciu nazw DataSet i .DataTable (Odziedziczone po DbDataAdapter)
Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior)	Dodaje lub odświeża wiersze w określonym zakresie w DataSet celu dopasowania ich do tych w źródle danych przy użyciu DataSet nazw tabel źródłowych i, ciągów poleceń i zachowania poleceń. (Odziedziczone po DbDataAdapter)
Fill(DataSet, String)	Dodaje lub odświeża wiersze w obiekcie, DataSet aby były zgodne z tymi w źródle danych przy użyciu nazw DataSet i DataTable . (Odziedziczone po DbDataAdapter)
Fill(DataSet, String, IDataReader, Int32, Int32)	Dodaje lub odświeża wiersze w określonym zakresie w DataSet celu dopasowania ich do tych w źródle danych przy użyciu nazw DataSet, DataTablei IDataReader . (Odziedziczone po DbDataAdapter)
Fill(DataTable)	Dodaje lub odświeża wiersze w określonym zakresie w DataSet celu dopasowania ich do tych w źródle danych przy użyciu DataTable nazwy. (Odziedziczone po DbDataAdapter)
Fill(DataTable, IDataReader)	Dodaje lub odświeża wiersze w obiekcie DataTable , aby pasować do tych w źródle danych przy użyciu określonych DataTable nazw i IDataReader . (Odziedziczone po DbDataAdapter)
Fill(DataTable, IDbCommand, CommandBehavior)	Dodaje lub odświeża wiersze w obiekcie DataTable , aby pasować do tych w źródle danych przy użyciu określonej wartości DataTablei IDbCommandCommandBehavior. (Odziedziczone po DbDataAdapter)
Fill(DataTable[], IDataReader, Int32, Int32)	Dodaje lub odświeża wiersze w określonym zakresie w kolekcji DataTable obiektów w celu dopasowania ich do tych w źródle danych. (Odziedziczone po DataAdapter)
Fill(DataTable[], Int32, Int32, IDbCommand, CommandBehavior)	Dodaje lub odświeża wiersze w określonym zakresie w DataSet celu dopasowania ich do tych w źródle danych przy użyciu nazw DataSet i .DataTable (Odziedziczone po DbDataAdapter)
Fill(Int32, Int32, DataTable[])	Dodaje lub odświeża wiersze w co najmniej jednym DataTable obiekcie, aby pasowały do tych w źródle danych rozpoczynającym się od określonego rekordu i pobieraniu do określonej maksymalnej liczby rekordów. (Odziedziczone po DbDataAdapter)
FillSchema(DataSet, SchemaType)	DataTable Dodaje nazwę "Tabela" do określonego DataSet i konfiguruje schemat tak, aby był zgodny z tym w źródle danych na podstawie określonego SchemaTypeelementu . (Odziedziczone po DbDataAdapter)
FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior)	Dodaje element DataTable do określonego DataSet i konfiguruje schemat, aby był zgodny z tym w źródle danych na podstawie określonego SchemaTypeelementu . (Odziedziczone po DbDataAdapter)
FillSchema(DataSet, SchemaType, String)	Dodaje element DataTable do określonego DataSet i konfiguruje schemat, aby był zgodny z tym w źródle danych na podstawie określonych wartości SchemaType i DataTable. (Odziedziczone po DbDataAdapter)
FillSchema(DataSet, SchemaType, String, IDataReader)	Dodaje element DataTable do określonego DataSetelementu . (Odziedziczone po DataAdapter)
FillSchema(DataTable, SchemaType)	Konfiguruje schemat określonego DataTable elementu na podstawie określonego SchemaTypeelementu . (Odziedziczone po DbDataAdapter)
FillSchema(DataTable, SchemaType, IDataReader)	Dodaje element DataTable do określonego DataSetelementu . (Odziedziczone po DataAdapter)
FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior)	Konfiguruje schemat określony DataTable na podstawie określonego SchemaType, ciągu polecenia i CommandBehavior wartości. (Odziedziczone po DbDataAdapter)
GetBatchedParameter(Int32, Int32)	Zwraca element IDataParameter z jednego z poleceń w bieżącej partii. (Odziedziczone po DbDataAdapter)
GetBatchedRecordsAffected(Int32, Int32, Exception)	Zwraca informacje o pojedynczej próbie aktualizacji w ramach większej aktualizacji wsadowej. (Odziedziczone po DbDataAdapter)
GetFillParameters()	Pobiera parametry ustawione przez użytkownika podczas wykonywania instrukcji SQL SELECT. (Odziedziczone po DbDataAdapter)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetLifetimeService()	Przestarzałe. Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetService(Type)	Zwraca obiekt reprezentujący usługę dostarczaną przez Component obiekt lub przez obiekt Container. (Odziedziczone po Component)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
HasTableMappings()	Wskazuje, czy DataTableMappingCollection element został utworzony. (Odziedziczone po DataAdapter)
InitializeBatching()	Inicjuje przetwarzanie wsadowe dla klasy DbDataAdapter. (Odziedziczone po DbDataAdapter)
InitializeLifetimeService()	Przestarzałe. Uzyskuje obiekt usługi okresu istnienia, aby kontrolować zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
OnFillError(FillErrorEventArgs)	FillError Zgłasza zdarzenie. (Odziedziczone po DbDataAdapter)
OnRowUpdated(RowUpdatedEventArgs)	Zgłasza zdarzenie dostawcy danych platformy RowUpdated .NET. (Odziedziczone po DbDataAdapter)
OnRowUpdating(RowUpdatingEventArgs)	Zgłasza zdarzenie dostawcy danych platformy RowUpdating .NET. (Odziedziczone po DbDataAdapter)
ResetFillLoadOption()	Resetuje FillLoadOption do stanu domyślnego i powoduje Fill(DataSet) honorowanie AcceptChangesDuringFillelementu . (Odziedziczone po DataAdapter)
ShouldSerializeAcceptChangesDuringFill()	Określa, czy AcceptChangesDuringFill właściwość powinna być utrwalone. (Odziedziczone po DataAdapter)
ShouldSerializeFillLoadOption()	Określa, czy FillLoadOption właściwość powinna być utrwalone. (Odziedziczone po DataAdapter)
ShouldSerializeTableMappings()	Określa, czy istnieje co najmniej jeden DataTableMapping obiekt i powinien być utrwalone. (Odziedziczone po DataAdapter)
TerminateBatching()	Kończy przetwarzanie wsadowe dla pliku DbDataAdapter. (Odziedziczone po DbDataAdapter)
ToString()	Zwraca wartość String zawierającą nazwę Componentobiektu , jeśli istnieje. Ta metoda nie powinna być zastępowana. (Odziedziczone po Component)
Update(DataRow[])	Aktualizacje wartości w bazie danych, wykonując odpowiednie instrukcje INSERT, UPDATE lub DELETE dla każdego wstawionego, zaktualizowanego lub usuniętego wiersza w określonej tablicy w DataSetobiekcie . (Odziedziczone po DbDataAdapter)
Update(DataRow[], DataTableMapping)	Aktualizacje wartości w bazie danych, wykonując odpowiednie instrukcje INSERT, UPDATE lub DELETE dla każdego wstawionego, zaktualizowanego lub usuniętego DataRow wiersza w określonej tablicy obiektów. (Odziedziczone po DbDataAdapter)
Update(DataSet)	Aktualizacje wartości w bazie danych, wykonując odpowiednie instrukcje INSERT, UPDATE lub DELETE dla każdego wstawionego, zaktualizowanego lub usuniętego wiersza w określonym DataSetwierszu . (Odziedziczone po DbDataAdapter)
Update(DataSet, String)	Aktualizacje wartości w bazie danych, wykonując odpowiednie instrukcje INSERT, UPDATE lub DELETE dla każdego wstawionego, zaktualizowanego lub usuniętego wiersza z DataSet określoną DataTable nazwą. (Odziedziczone po DbDataAdapter)
Update(DataTable)	Aktualizacje wartości w bazie danych, wykonując odpowiednie instrukcje INSERT, UPDATE lub DELETE dla każdego wstawionego, zaktualizowanego lub usuniętego wiersza w określonym DataTablewierszu . (Odziedziczone po DbDataAdapter)

Zdarzenia

Disposed	Występuje, gdy składnik jest usuwany przez wywołanie Dispose() metody . (Odziedziczone po Component)
FillError	Zwracany, gdy wystąpił błąd podczas operacji wypełniania. (Odziedziczone po DbDataAdapter)
RowUpdated	Występuje podczas operacji aktualizacji po wykonaniu polecenia względem źródła danych.
RowUpdating	Występuje podczas Update(DataSet) wykonywania polecenia względem źródła danych.

Jawne implementacje interfejsu

ICloneable.Clone()	Aby uzyskać opis tego elementu członkowskiego, zobacz Clone().
IDataAdapter.TableMappings	Pobiera kolekcję wskazującą sposób mapowania tabeli źródłowej na tabelę zestawu danych. (Odziedziczone po DataAdapter)
IDbDataAdapter.DeleteCommand	Aby uzyskać opis tego elementu członkowskiego, zobacz DeleteCommand.
IDbDataAdapter.InsertCommand	Aby uzyskać opis tego elementu członkowskiego, zobacz InsertCommand.
IDbDataAdapter.SelectCommand	Aby uzyskać opis tego elementu członkowskiego, zobacz SelectCommand.
IDbDataAdapter.UpdateCommand	Aby uzyskać opis tego elementu członkowskiego, zobacz UpdateCommand.

Zobacz też

• Elementy DataAdapter i DataReader