SqlDataAdapter Klasa

Definicja

Przestrzeń nazw:

System.Data.SqlClient

Zestaw:

System.Data.dll

Reprezentuje zestaw poleceń danych i połączenie bazy danych używane do wypełniania DataSet i aktualizowania bazy danych SQL Server. Klasa ta nie może być dziedziczona.

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

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

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

Public NotInheritable Class SqlDataAdapter
Inherits DbDataAdapter
Implements ICloneable

Dziedziczenie

Object

MarshalByRefObject

Component

DataAdapter

DbDataAdapter

SqlDataAdapter

Implementuje

IDataAdapter IDbDataAdapter ICloneable

Przykłady

W poniższym przykładzie użyto wartości SqlCommand, SqlDataAdapteri SqlConnection do wybrania rekordów z bazy danych i wypełnienia obiektu DataSet wybranymi wierszami. Wypełnione DataSet są następnie zwracane. Aby to osiągnąć, metoda jest przekazywana zainicjowana DataSet, parametry połączenia i ciąg zapytania, który jest instrukcją Transact-SQL SELECT.

private static DataSet SelectRows(DataSet dataset,
    string connectionString,string queryString)
{
    using (SqlConnection connection =
        new SqlConnection(connectionString))
    {
        SqlDataAdapter adapter = new SqlDataAdapter();
        adapter.SelectCommand = new SqlCommand(
            queryString, connection);
        adapter.Fill(dataset);
        return dataset;
    }
}

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

    Using connection As New SqlConnection(connectionString)
        Dim adapter As New SqlDataAdapter()
        adapter.SelectCommand = New SqlCommand( _
            queryString, connection)
        adapter.Fill(dataSet)
        Return dataSet
    End Using
End Function

Uwagi

Element SqlDataAdaptersłuży jako most między SQL Server a DataSet i do pobierania i zapisywania danych. Zapewnia SqlDataAdapter ten mostek przez mapowanie Fill, które zmienia dane w DataSet obiekcie w celu dopasowania ich do danych w źródle danych i Update, które zmienia dane w źródle danych w celu dopasowania ich do danych w DataSetelemecie , przy użyciu odpowiednich instrukcji języka Transact-SQL względem źródła danych. Aktualizacja jest wykonywana według wierszy. Dla każdego wstawionego, zmodyfikowanego i usuniętego wiersza Update metoda określa typ zmiany, która została na nim wykonana (Insert, Updatelub Delete). W zależności od typu zmiany Insertszablon polecenia , Updatelub Delete jest wykonywany w celu propagowania zmodyfikowanego wiersza do źródła danych. SqlDataAdapter Gdy obiekt wypełnia DataSetelement , tworzy niezbędne 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ć SqlDataAdapter 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.

SqlDataAdapterjest używany w połączeniu z elementami SqlConnection i SqlCommand w celu zwiększenia wydajności podczas nawiązywania połączenia z bazą danych SQL Server.

Uwaga

Jeśli używasz SQL Server procedur składowanych do edytowania lub usuwania danych przy użyciu elementu DataAdapter, upewnij się, że nie używasz funkcji SET NOCOUNT ON w definicji procedury składowanej. Powoduje to zwrócenie liczby wierszy, których dotyczy problem, wynosi zero, co DataAdapter jest interpretowane jako konflikt współbieżności. W tym przypadku zostanie zgłoszony element DBConcurrencyException .

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

Po utworzeniu SqlDataAdapter wystąpienia obiektu właściwości odczytu/zapisu są ustawiane na wartości początkowe. Aby uzyskać listę tych wartości, zobacz SqlDataAdapter konstruktor.

DeleteCommand, InsertCommandi UpdateCommand są szablonami ogólnymi, które są automatycznie wypełniane poszczególnymi wartościami z każdego zmodyfikowanego wiersza za pośrednictwem mechanizmu parametrów.

Dla każdej kolumny propagowanej do źródła danych w Updateusłudze należy dodać parametr do InsertCommandelementu , UpdateCommandlub DeleteCommand. Właściwość SourceColumnDbParameter obiektu powinna być ustawiona na nazwę kolumny. To ustawienie wskazuje, że wartość parametru nie jest ustawiana ręcznie, ale jest pobierana z określonej kolumny w aktualnie przetworzonym wierszu.

Uwaga

Wystąpi InvalidOperationException , jeśli Fill metoda jest wywoływana, a tabela zawiera typ zdefiniowany przez użytkownika, który nie jest dostępny na komputerze klienckim. Aby uzyskać więcej informacji, zobacz CLR User-Defined Types (Typy User-Defined CLR).

Konstruktory

SqlDataAdapter()	Inicjuje nowe wystąpienie klasy SqlDataAdapter.
SqlDataAdapter(SqlCommand)	Inicjuje SqlDataAdapter nowe wystąpienie klasy z określoną SqlCommand właściwością SelectCommand .
SqlDataAdapter(String, SqlConnection)	Inicjuje SqlDataAdapter nowe wystąpienie klasy z SelectCommand obiektem SqlConnection i.
SqlDataAdapter(String, String)	Inicjuje SqlDataAdapter nowe wystąpienie klasy z SelectCommand parametry połączenia i.

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ę Języka Transact-SQL lub procedurę składowaną w celu usunięcia 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ę Języka Transact-SQL lub procedurę składowaną, aby wstawić nowe rekordy 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ę Języka Transact-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 liczbę wierszy przetwarzanych w każdej rundzie na serwerze.
UpdateCommand	Pobiera lub ustawia instrukcję Języka Transact-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()	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, więc zdarzenie zostanie wyzwolone.
RowUpdating	Występuje podczas Update(DataSet) wykonywania polecenia względem źródła danych. Podjęto próbę aktualizacji, więc zdarzenie zostanie wyzwolone.

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
• Manipulowanie danymi (ADO.NET)
• Omówienie ADO.NET