SqlDataAdapter Klasa

Definicja

Przestrzeń nazw:

System.Data.SqlClient

Zestaw:

System.Data.SqlClient.dll

Pakiet:

System.Data.SqlClient v4.8.6

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

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

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

Public NotInheritable Class SqlDataAdapter
Inherits DbDataAdapter

Dziedziczenie

Object

MarshalByRefObject

Component

DataAdapter

DbDataAdapter

SqlDataAdapter

Implementuje

IDataAdapter IDbDataAdapter ICloneable

Przykłady

W poniższym przykładzie użyto elementu SqlCommand, SqlDataAdapteri SqlConnection do wybrania rekordów z bazy danych i wypełnienia DataSet wartością z wybranymi wierszami. Następnie zostanie zwrócony wypełniony DataSet . Aby to osiągnąć, metoda jest przekazywana zainicjowana DataSet, parametry połączenia i parametry zapytania, które są 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 SqlDataAdapter, służy jako most między SQL Server a DataSet na potrzeby pobierania i zapisywania danych. Ten SqlDataAdapter most zapewnia mapowanie Fill, które zmienia dane w obiekcie tak DataSet , aby odpowiadały danym w źródle danych i Update, które zmienia dane w źródle danych, aby pasować do danych w elemecie DataSet, 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 wykonana na nim (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. Po wypełnieniu SqlDataAdapter elementu DataSetelement tworzy niezbędne 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 SqlDataAdapter 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.

SqlDataAdapterjest używany w połączeniu z i SqlConnectionSqlCommand 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, że liczba wierszy, których dotyczy problem, zwraca wartość zero, która DataAdapter jest interpretowana jako konflikt współbieżności. W tym przypadku DBConcurrencyException zostanie zgłoszony element .

Zawiera SqlDataAdapter również SelectCommandwłaściwości , , InsertCommandDeleteCommand, UpdateCommand, i TableMappings w celu ułatwienia ładowania i aktualizowania danych.

Po utworzeniu SqlDataAdapter wystąpienia właściwości odczytu/zapisu są ustawione 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, która jest propagowana do źródła danych w systemie Update, parametr powinien zostać dodany 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 za pomocą obiektu SelectCommand i SqlConnection .
SqlDataAdapter(String, String)	Inicjuje SqlDataAdapter nowe wystąpienie klasy za pomocą parametrów SelectCommand połączenia i .

Pola

DefaultSourceTableName

Domyślna nazwa używana przez DataAdapter obiekt do mapowania tabel. (Odziedziczone po DbDataAdapter)

Właściwości

AcceptChangesDuringFill	Pobiera lub ustawia wartość wskazującą, czy AcceptChanges() jest wywoływana na obiekcie DataRow po dodaniu do DataTable obiektu podczas dowolnej 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 w przypadku wystąpienia błędu podczas aktualizacji wiersza. (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 LoadOption element określający sposób wypełniania DataTable obiektu przez adapter z obiektu 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ę, która ma być wykonywana, gdy dane przychodzące nie mają zgodnej 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 wartość ISite .Component (Odziedziczone po Component)
TableMappings	Pobiera kolekcję, która udostępnia podstawowe mapowanie między tabelą źródłową DataTablea . (Odziedziczone po DataAdapter)
UpdateBatchSize	Pobiera lub ustawia liczbę wierszy, które są przetwarzane 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 IDbCommand do bieżącej partii. (Odziedziczone po DbDataAdapter)
ClearBatch()	Usuwa wszystkie IDbCommand obiekty z partii. (Odziedziczone po DbDataAdapter)
CloneInternals()	Tworzy kopię tego wystąpienia klasy 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 obiekcie w celu dopasowania ich do tych w źródle danych przy użyciu DataSet nazw i DataTable . (Odziedziczone po DbDataAdapter)
Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior)	Dodaje lub odświeża wiersze w określonym zakresie w DataSet obiekcie , aby były zgodne z tymi w źródle danych przy użyciu DataSet nazw tabel źródłowych i źródłowych, ciągów poleceń i zachowania polecenia. (Odziedziczone po DbDataAdapter)
Fill(DataSet, String)	Dodaje lub odświeża wiersze w DataSet obiekcie w celu dopasowania ich do tych w źródle danych przy użyciu DataSet nazw i DataTable . (Odziedziczone po DbDataAdapter)
Fill(DataSet, String, IDataReader, Int32, Int32)	Dodaje lub odświeża wiersze w określonym zakresie w DataSet obiekcie w celu dopasowania ich do tych w źródle danych przy użyciu DataSetnazw , DataTablei IDataReader . (Odziedziczone po DbDataAdapter)
Fill(DataTable)	Dodaje lub odświeża wiersze w określonym zakresie w DataSet obiekcie w celu dopasowania ich do wierszy w źródle danych przy użyciu DataTable nazwy . (Odziedziczone po DbDataAdapter)
Fill(DataTable, IDataReader)	Dodaje lub odświeża wiersze w obiekcie DataTable w celu dopasowania ich 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 DataTable obiekcie w celu dopasowania ich do tych w źródle danych przy użyciu określonych DataTableelementów i 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 wierszy 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 obiekcie w celu dopasowania ich do tych w źródle danych przy użyciu DataSet nazw i DataTable . (Odziedziczone po DbDataAdapter)
Fill(Int32, Int32, DataTable[])	Dodaje lub odświeża wiersze w co najmniej jednym DataTable obiekcie w celu dopasowania ich do tych w źródle danych, począwszy od określonego rekordu i pobierania do określonej maksymalnej liczby rekordów. (Odziedziczone po DbDataAdapter)
FillSchema(DataSet, SchemaType)	DataTable Dodaje nazwę "Tabela" do określonego DataSet i konfiguruje schemat w taki sposób, aby był zgodny z tym w źródle danych na podstawie określonego SchemaTypeelementu . (Odziedziczone po DbDataAdapter)
FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior)	DataTable Dodaje element do określonego DataSet elementu i konfiguruje schemat tak, aby był zgodny z tym w źródle danych na podstawie określonego SchemaTypeelementu . (Odziedziczone po DbDataAdapter)
FillSchema(DataSet, SchemaType, String)	DataTable Dodaje element do określonego DataSet elementu i konfiguruje schemat tak, aby był zgodny z tym w źródle danych na podstawie określonych SchemaType wartości 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ślonego DataTable elementu 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, który reprezentuje usługę dostarczaną przez Component obiekt lub przez element 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()	Uzyskuje obiekt usługi okresu istnienia w celu kontrolowania zasad 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 AcceptChangesDuringFill. (Odziedziczone po DataAdapter)
ShouldSerializeAcceptChangesDuringFill()	Określa, czy AcceptChangesDuringFill właściwość ma być utrwalone. (Odziedziczone po DataAdapter)
ShouldSerializeFillLoadOption()	Określa, czy FillLoadOption właściwość ma być utrwalone. (Odziedziczone po DataAdapter)
ShouldSerializeTableMappings()	Określa, czy istnieje co najmniej jeden DataTableMapping obiekt i czy powinny być utrwalane. (Odziedziczone po DataAdapter)
TerminateBatching()	Kończy przetwarzanie wsadowe dla .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 w DataSet obiekcie o określonej DataTable nazwie. (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 wykonywania Update(DataSet) polecenia względem źródła danych. Podjęto próbę aktualizacji, więc zdarzenie jest uruchamiane.
RowUpdating	Występuje podczas wykonywania Update(DataSet) polecenia względem źródła danych. Podjęto próbę aktualizacji, więc zdarzenie jest uruchamiane.

Jawne implementacje interfejsu

ICloneable.Clone()	Aby uzyskać opis tego członka, zobacz Clone().
IDbDataAdapter.DeleteCommand	Aby uzyskać opis tego członka, zobacz DeleteCommand.
IDbDataAdapter.InsertCommand	Aby uzyskać opis tego członka, zobacz InsertCommand.
IDbDataAdapter.SelectCommand	Aby uzyskać opis tego członka, zobacz SelectCommand.
IDbDataAdapter.UpdateCommand	Aby uzyskać opis tego członka, zobacz UpdateCommand.

Zobacz też

• Elementy DataAdapter i DataReader
• Manipulowanie danymi (ADO.NET)
• Omówienie ADO.NET