OleDbDataAdapter Klasa

Definicja

Przestrzeń nazw:

System.Data.OleDb

Zestaw:

System.Data.OleDb.dll

Pakiet:

System.Data.OleDb v8.0.0

Source:

OleDbDataAdapter.cs

Reprezentuje zestaw poleceń danych i połączenie bazy danych, które są używane do wypełniania DataSet i aktualizowania źródła danych.

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

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

Dziedziczenie

Object

MarshalByRefObject

Component

DataAdapter

DbDataAdapter

OleDbDataAdapter

Implementuje

IDataAdapter IDbDataAdapter ICloneable

Przykłady

W poniższym przykładzie użyto OleDbCommandelementów , OleDbDataAdapter i OleDbConnection, aby wybrać rekordy ze źródła danych programu Access i wypełnić element DataSet wybranymi wierszami. Wypełnione DataSet są następnie zwracane. Aby to osiągnąć, metoda jest przekazywana zainicjowana DataSet, parametry połączenia i parametry zapytania, które są instrukcją 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

Uwagi

Element OleDbDataAdapter służy jako most między źródłem danych i DataSet do pobierania i zapisywania danych. Element OleDbDataAdapter udostępnia ten most za pomocą polecenia Fill w celu zał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 OleDbDataAdapterDataSetobiektu element utworzy odpowiednie tabele i kolumny dla zwróconych 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 AddWithKeywartość . Możesz również utworzyć OleDbDataAdapter schemat obiektu , w tym informacje o kluczu DataSetpodstawowym, przed wypełnieniem ich danymi przy użyciu polecenia FillSchema. Aby uzyskać więcej informacji, zobacz Dodawanie istniejących ograniczeń do zestawu danych.

Należy pamiętać, że niektórzy dostawcy OLE DB, w tym dostawca MSDataShape, nie zwracają tabeli podstawowej ani informacji o kluczu podstawowym. W związku z tym OleDbDataAdapter właściwość nie może poprawnie ustawić dla żadnej utworzonej PrimaryKeyDataTablewłaściwości . W takich przypadkach należy jawnie określić klucze podstawowe dla tabel w obiekcie DataSet.

Zawiera OleDbDataAdapter również SelectCommandwłaściwości , InsertCommand, DeleteCommand, UpdateCommandi TableMappings ułatwiające ładowanie i aktualizowanie danych.

Podczas tworzenia wystąpienia OleDbDataAdapterwłaściwości właściwości są ustawiane na ich wartości początkowe. Aby uzyskać listę tych wartości, zobacz OleDbDataAdapter konstruktor.

Konstruktory

OleDbDataAdapter()	Inicjuje nowe wystąpienie klasy OleDbDataAdapter.
OleDbDataAdapter(OleDbCommand)	Inicjuje OleDbDataAdapter nowe wystąpienie klasy z określoną OleDbCommand właściwością SelectCommand .
OleDbDataAdapter(String, OleDbConnection)	Inicjuje OleDbDataAdapter nowe wystąpienie klasy za pomocą klasy SelectCommand.
OleDbDataAdapter(String, String)	Inicjuje OleDbDataAdapter nowe wystąpienie klasy za pomocą klasy SelectCommand.

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ą na potrzeby usuwania rekordów z zestawu 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()	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, Object, String)	Dodaje lub odświeża wiersze w obiekcie, DataSet aby były zgodne z tymi w obiekcie ADO lub Record przy użyciu określonej DataSetnazwy tabeli źródłowej , obiektu ADO Recordset i tabeli źródłowej.
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, Object)	Dodaje lub odświeża wiersze w obiekcieDataTable, aby dopasować je do obiektów ADO lub Record ADO Recordset przy użyciu określonych DataTable obiektów i ADO.
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()	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 wartość bieżącego wystąpienia. (Odziedziczone po Object)
HasTableMappings()	Wskazuje, czy DataTableMappingCollection element został utworzony. (Odziedziczone po DataAdapter)
InitializeBatching()	Inicjuje przetwarzanie wsadowe dla klasy DbDataAdapter. (Odziedziczone po DbDataAdapter)
InitializeLifetimeService()	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 Update(DataSet) wykonywania polecenia względem źródła danych. Podjęto próbę aktualizacji. W związku z tym zdarzenie występuje.
RowUpdating	Występuje podczas Update(DataSet) wykonywania polecenia względem źródła danych. Podjęto próbę aktualizacji. W związku z tym zdarzenie występuje.

Jawne implementacje interfejsu

ICloneable.Clone()	Aby uzyskać opis tego elementu członkowskiego, zobacz Clone().
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