SqlDataAdapter Osztály

Definíció

Névtér:

System.Data.SqlClient

Szerelvény:

System.Data.dll

A DataSet kitöltéséhez és egy SQL Server-adatbázis frissítéséhez használt adatparancsok és adatbáziskapcsolatok készletét jelöli. Ez az osztály nem örökölhető.

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

Öröklődés

Object

MarshalByRefObject

Component

DataAdapter

DbDataAdapter

SqlDataAdapter

Megvalósítás

IDataAdapter IDbDataAdapter ICloneable

Példák

Az alábbi példa a SqlCommand, SqlDataAdapterés a rekordok adatbázisból való kiválasztására és SqlConnection a kijelölt sorokkal való feltöltésére DataSet használja. Ezután visszaadja a kitöltött elemet DataSet . Ennek elvégzéséhez a metódus egy inicializált DataSet, egy kapcsolati karakterlánc és egy Transact-SQL SELECT utasítást tartalmazó lekérdezési sztringet ad át.

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

Megjegyzések

A SqlDataAdapter hídként szolgál egy DataSet és SQL Server között az adatok lekéréséhez és mentéséhez. A SqlDataAdapter az Fill leképezésével biztosítja ezt a hidat, amely a DataSet adatait az adatforrás adatainak megfelelően módosítja, és Update, amely az adatforrásban lévő adatokat a DataSet adatainak megfelelően módosítja az adatforráshoz tartozó megfelelő Transact-SQL utasításokkal. A frissítés soronként történik. Minden beszúrt, módosított és törölt sor esetében a Update metódus határozza meg a rajta végrehajtott módosítás típusát (Insertvagy UpdateDelete). A módosítás típusától függően a Insert, Updatevagy Delete parancssablon végrehajtja a módosított sor adatforrásba való propagálását. SqlDataAdapter A kitöltéskor DataSetlétrehozza a visszaadott adatokhoz szükséges táblákat és oszlopokat, ha még nem léteznek. Az elsődleges kulcs információi azonban csak akkor szerepelnek az implicit módon létrehozott sémában, ha a MissingSchemaAction tulajdonság értéke AddWithKey. Az elsődleges kulcsadatokkal együtt létrehozhatja a sémát isSqlDataAdapter, mielőtt adatokat töltené ki a használatávalDataSet.FillSchema További információ: Meglévő megkötések hozzáadása adathalmazhoz.

SqlDataAdapter SqlConnection és SqlCommand együtt használják, hogy növelje a teljesítményt SQL Server adatbázishoz való csatlakozáskor.

Note

Ha SQL Server tárolt eljárásokat használ adatok szerkesztésére vagy törlésére egy DataAdapter segítségével, győződjön meg arról, hogy nem használja a SET NOCOUNT ON beállítást a tárolt eljárás definíciójában. Ez azt eredményezi, hogy az érintett sorok száma nulla lesz, amelyet az DataAdapter egyidejűségütközésként értelmez. Ebben az esetben egy DBConcurrencyException lesz dobva.

Az SqlDataAdapter adatok betöltésének SelectCommandés frissítésének megkönnyítése érdekében a , InsertCommand, DeleteCommand, UpdateCommandés TableMappings tulajdonságokat is tartalmazza.

Amikor létrejön egy példány SqlDataAdapter , az olvasási/írási tulajdonságok kezdeti értékekre vannak állítva. Ezeknek az értékeknek a listáját a konstruktorban SqlDataAdapter találja.

A InsertCommand, DeleteCommandés UpdateCommand általános sablonok, amelyek automatikusan kitöltik az egyes értékeket minden módosított sorból a paraméterek mechanizmusán keresztül.

Minden olyan oszlophoz, amelyen az adatforrásba Updatepropagálja az adatokat, hozzá kell adni egy paramétert az InsertCommand, UpdateCommandvagy DeleteCommand. Az SourceColumn objektum tulajdonságát az DbParameter oszlop nevére kell állítani. Ez a beállítás azt jelzi, hogy a paraméter értéke nincs manuálisan beállítva, hanem az aktuálisan feldolgozott sor adott oszlopából származik.

Note

Ez InvalidOperationException akkor fordul elő, ha a Fill metódust meghívják, és a tábla olyan felhasználó által definiált típust tartalmaz, amely nem érhető el az ügyfélszámítógépen. További információért lásd: CLR felhasználó által definiált típusok.

Konstruktorok

Name	Description
SqlDataAdapter()	Inicializálja a SqlDataAdapter osztály új példányát.
SqlDataAdapter(SqlCommand)	Inicializálja az osztály új példányát SqlDataAdapter a megadott SqlCommandSelectCommand tulajdonsággal.
SqlDataAdapter(String, SqlConnection)	Inicializálja az SqlDataAdapter osztály új példányát egy SelectCommand és egy SqlConnection objektummal.
SqlDataAdapter(String, String)	Inicializálja a SqlDataAdapter osztály új példányát egy SelectCommand és egy kapcsolati karakterlánc.

Mezők

Name	Description
DefaultSourceTableName	Az objektum által a DataAdapter táblaleképezésekhez használt alapértelmezett név. (Öröklődés forrása DbDataAdapter)

Tulajdonságok

Name	Description
AcceptChangesDuringFill	Lekéri vagy beállít egy értéket, amely jelzi, hogy a AcceptChanges() során a rendszer meghívja-e DataRowDataTable őket. (Öröklődés forrása DataAdapter)
AcceptChangesDuringUpdate	Lekérdezi vagy beállítja, hogy a rendszer meghívja-e AcceptChanges() egy Update(DataSet). (Öröklődés forrása DataAdapter)
CanRaiseEvents	Beolvas egy értéket, amely jelzi, hogy az összetevő képes-e eseményt létrehozni. (Öröklődés forrása Component)
Container	Lekéri a IContainer .Component (Öröklődés forrása Component)
ContinueUpdateOnError	Lekéri vagy beállítja azt az értéket, amely meghatározza, hogy kivételt hozzon-e létre, ha hiba történik egy sorfrissítés során. (Öröklődés forrása DataAdapter)
DeleteCommand	Lekéri vagy beállít egy Transact-SQL utasítást vagy tárolt eljárást a rekordok adatkészletből való törléséhez.
DesignMode	Olyan értéket kap, amely jelzi, hogy az Component aktuálisan tervezési módban van-e. (Öröklődés forrása Component)
Events	Lekéri az ehhez Componentcsatolt eseménykezelők listáját. (Öröklődés forrása Component)
FillCommandBehavior	Lekéri vagy beállítja az adatadapter kitöltéséhez használt parancs viselkedését. (Öröklődés forrása DbDataAdapter)
FillLoadOption	Lekéri vagy beállítja azt, LoadOption amely meghatározza, hogy az adapter hogyan tölti ki az adaptert a DataTableDbDataReaderfájlból. (Öröklődés forrása DataAdapter)
InsertCommand	Lekéri vagy beállít egy Transact-SQL utasítást vagy tárolt eljárást új rekordok adatforrásba való beszúrásához.
MissingMappingAction	Meghatározza, hogy milyen műveletet kell elvégezni, ha a bejövő adatok nem rendelkeznek egyező táblával vagy oszloppal. (Öröklődés forrása DataAdapter)
MissingSchemaAction	Meghatározza a végrehajtandó műveletet, ha a meglévő DataSet séma nem egyezik a bejövő adatokkal. (Öröklődés forrása DataAdapter)
ReturnProviderSpecificTypes	Lekérdezi vagy beállítja, hogy a metódusnak Fill szolgáltatóspecifikus értékeket vagy általános CLS-kompatibilis értékeket kell-e visszaadnia. (Öröklődés forrása DataAdapter)
SelectCommand	Lekéri vagy beállít egy Transact-SQL utasítást vagy tárolt eljárást az adatforrás rekordjainak kiválasztásához.
Site	Lekéri vagy megadja a ISite értékét a Component-hez. (Öröklődés forrása Component)
TableMappings	Lekéri a forrástábla és a forrástábla közötti elsődleges leképezést biztosító gyűjteményt DataTable. (Öröklődés forrása DataAdapter)
UpdateBatchSize	Lekéri vagy beállítja a kiszolgálóra való minden oda-visszaút során feldolgozott sorok számát.
UpdateCommand	Lekéri vagy beállít egy Transact-SQL utasítást vagy tárolt eljárást az adatforrás rekordjainak frissítéséhez.

Metódusok

Name	Description
AddToBatch(IDbCommand)	Hozzáad egy IDbCommand elemet az aktuális köteghez. (Öröklődés forrása DbDataAdapter)
ClearBatch()	Eltávolítja az összes IDbCommand objektumot a kötegből. (Öröklődés forrása DbDataAdapter)
CloneInternals()	Elavult. Létrehozza a példány másolatát DataAdapter. (Öröklődés forrása DataAdapter)
CreateObjRef(Type)	Létrehoz egy objektumot, amely tartalmazza a távoli objektumokkal való kommunikációhoz használt proxy létrehozásához szükséges összes releváns információt. (Öröklődés forrása MarshalByRefObject)
CreateRowUpdatedEvent(DataRow, IDbCommand, StatementType, DataTableMapping)	Inicializálja a RowUpdatedEventArgs osztály új példányát. (Öröklődés forrása DbDataAdapter)
CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping)	Inicializálja a RowUpdatingEventArgs osztály új példányát. (Öröklődés forrása DbDataAdapter)
CreateTableMappings()	Létrehoz egy újat DataTableMappingCollection. (Öröklődés forrása DataAdapter)
Dispose()	Felszabadítja a .-hez használt összes erőforrást Component. (Öröklődés forrása Component)
Dispose(Boolean)	Felszabadítja a felügyelt erőforrások által DbDataAdapter használt nem felügyelt erőforrásokat, és opcionálisan felszabadítja a felügyelt erőforrásokat. (Öröklődés forrása DbDataAdapter)
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
ExecuteBatch()	Végrehajtja az aktuális köteget. (Öröklődés forrása DbDataAdapter)
Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior)	Egy megadott tartomány sorait adja hozzá vagy frissíti, DataSet hogy azok egyezzenek az adatforrásban lévőkkel a táblanevek, a parancssztring és a DataSet parancs viselkedése alapján. (Öröklődés forrása DbDataAdapter)
Fill(DataSet, Int32, Int32, String)	Egy megadott tartomány sorait adja hozzá vagy frissíti, DataSet hogy azok egyezzenek az adatforrásban lévőkkel a nevek és DataSet a DataTable nevek használatával. (Öröklődés forrása DbDataAdapter)
Fill(DataSet, String)	Sorokat ad hozzá vagy frissít, DataSet hogy megfeleljen az adatforrásban lévőknek a nevek és DataSet a DataTable nevek használatával. (Öröklődés forrása DbDataAdapter)
Fill(DataSet)	Sorokat ad hozzá vagy frissít a DataSetfájlban. (Öröklődés forrása DbDataAdapter)
Fill(DataTable, IDbCommand, CommandBehavior)	Sorokat ad hozzá vagy frissít az DataTable adatforrásban lévőknek a megadott DataTableés IDbCommandCommandBehavior. (Öröklődés forrása DbDataAdapter)
Fill(DataTable)	Egy megadott tartomány sorait adja hozzá vagy frissíti, DataSet hogy azok egyezzenek az adatforrásban lévőkkel a DataTable név használatával. (Öröklődés forrása DbDataAdapter)
Fill(DataTable[], IDataReader, Int32, Int32)	Egy adott tartomány sorait adja hozzá vagy frissíti az objektumgyűjteményben DataTable , hogy azok megfeleljenek az adatforrásban lévőknek. (Öröklődés forrása DataAdapter)
Fill(DataTable[], Int32, Int32, IDbCommand, CommandBehavior)	Egy megadott tartomány sorait adja hozzá vagy frissíti, DataSet hogy azok egyezzenek az adatforrásban lévőkkel a nevek és DataSet a DataTable nevek használatával. (Öröklődés forrása DbDataAdapter)
Fill(Int32, Int32, DataTable[])	Egy vagy több DataTable objektum sorait adja hozzá vagy frissíti, hogy azok egyezzenek az adatforrásban a megadott rekordtól kezdődően és a megadott maximális rekordszámig beolvasva. (Öröklődés forrása DbDataAdapter)
FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior)	Hozzáad egy értéket DataTable a megadotthoz DataSet , és úgy konfigurálja a sémát, hogy az megfeleljen az adatforrásnak a megadott SchemaTypealapján. (Öröklődés forrása DbDataAdapter)
FillSchema(DataSet, SchemaType, String, IDataReader)	Hozzáad egy értéket DataTable a megadotthoz DataSet. (Öröklődés forrása DataAdapter)
FillSchema(DataSet, SchemaType, String)	Hozzáad egy értéket DataTable a megadotthoz DataSet , és úgy konfigurálja a sémát, hogy az megfeleljen az adatforrásban megadott SchemaType és DataTable. (Öröklődés forrása DbDataAdapter)
FillSchema(DataSet, SchemaType)	Hozzáad egy DataTable "Table" nevű táblát a megadotthoz DataSet , és úgy konfigurálja a sémát, hogy az megfeleljen az adatforrásnak a megadott SchemaTypealapján. (Öröklődés forrása DbDataAdapter)
FillSchema(DataTable, SchemaType, IDataReader)	Hozzáad egy értéket DataTable a megadotthoz DataSet. (Öröklődés forrása DataAdapter)
FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior)	A megadott DataTable séma konfigurálása a megadott SchemaTypeparancssztring és CommandBehavior értékek alapján. (Öröklődés forrása DbDataAdapter)
FillSchema(DataTable, SchemaType)	A megadott séma konfigurálása a megadott DataTableSchemaTypealapján. (Öröklődés forrása DbDataAdapter)
GetBatchedParameter(Int32, Int32)	Az aktuális köteg egyik parancsából ad vissza egy IDataParameter értéket. (Öröklődés forrása DbDataAdapter)
GetBatchedRecordsAffected(Int32, Int32, Exception)	Egy nagyobb kötegelt frissítésen belüli egyes frissítési kísérletekkel kapcsolatos információkat ad vissza. (Öröklődés forrása DbDataAdapter)
GetFillParameters()	Lekéri a felhasználó által az SQL SELECT utasítás végrehajtásakor beállított paramétereket. (Öröklődés forrása DbDataAdapter)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetLifetimeService()	Lekéri a példány élettartamszabályzatát vezérlő aktuális élettartam-szolgáltatásobjektumot. (Öröklődés forrása MarshalByRefObject)
GetService(Type)	Olyan objektumot ad vissza, amely az általa vagy annak által ComponentContainernyújtott szolgáltatást jelöli. (Öröklődés forrása Component)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
HasTableMappings()	Azt jelzi, hogy létrejött-e.DataTableMappingCollection (Öröklődés forrása DataAdapter)
InitializeBatching()	Inicializálja a kötegelést a DbDataAdapter. (Öröklődés forrása DbDataAdapter)
InitializeLifetimeService()	Beolvas egy élettartam-szolgáltatásobjektumot a példány élettartam-szabályzatának szabályozásához. (Öröklődés forrása MarshalByRefObject)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
MemberwiseClone(Boolean)	Az aktuális MarshalByRefObject objektum sekély másolatát hozza létre. (Öröklődés forrása MarshalByRefObject)
OnRowUpdated(RowUpdatedEventArgs)	Egy .NET adatszolgáltató RowUpdated eseményét emeli ki. (Öröklődés forrása DbDataAdapter)
OnRowUpdating(RowUpdatingEventArgs)	Egy .NET adatszolgáltató RowUpdating eseményét emeli ki. (Öröklődés forrása DbDataAdapter)
ResetFillLoadOption()	Alaphelyzetbe állítja FillLoadOption az alapértelmezett állapotát, és a tisztelet Fill(DataSet)okaitAcceptChangesDuringFill. (Öröklődés forrása DataAdapter)
ShouldSerializeAcceptChangesDuringFill()	Meghatározza, hogy a AcceptChangesDuringFill tulajdonságot meg kell-e őrizni. (Öröklődés forrása DataAdapter)
ShouldSerializeFillLoadOption()	Meghatározza, hogy a FillLoadOption tulajdonságot meg kell-e őrizni. (Öröklődés forrása DataAdapter)
ShouldSerializeTableMappings()	Meghatározza, hogy létezik-e egy vagy több DataTableMapping objektum, és meg kell-e őrizni őket. (Öröklődés forrása DataAdapter)
TerminateBatching()	Befejezi a kötegelést a DbDataAdapter. (Öröklődés forrása DbDataAdapter)
ToString()	String A ( ha van) nevet tartalmazó értéket Componentad vissza. Ezt a módszert nem szabad felülírni. (Öröklődés forrása Component)
Update(DataRow[], DataTableMapping)	Az adatbázis értékeit úgy frissíti, hogy végrehajtja a megfelelő INSERT, UPDATE vagy DELETE utasításokat a megadott objektumtömb minden egyes beszúrt, frissített vagy törölt sorához DataRow . (Öröklődés forrása DbDataAdapter)
Update(DataRow[])	Az adatbázis értékeit úgy frissíti, hogy végrehajtja a megfelelő INSERT, UPDATE vagy DELETE utasításokat a megadott tömbben lévő minden egyes beszúrt, frissített vagy törölt sorhoz DataSet. (Öröklődés forrása DbDataAdapter)
Update(DataSet, String)	Az adatbázis értékeit úgy frissíti, hogy végrehajtja a megfelelő INSERT, UPDATE vagy DELETE utasításokat a DataSet megadott DataTable névvel rendelkező összes beszúrt, frissített vagy törölt sorhoz. (Öröklődés forrása DbDataAdapter)
Update(DataSet)	Az adatbázis értékeinek frissítéséhez hajtsa végre a megfelelő INSERT, UPDATE vagy DELETE utasításokat a megadott DataSetsor minden egyes beszúrt, frissített vagy törölt sorához. (Öröklődés forrása DbDataAdapter)
Update(DataTable)	Az adatbázis értékeinek frissítéséhez hajtsa végre a megfelelő INSERT, UPDATE vagy DELETE utasításokat a megadott DataTablesor minden egyes beszúrt, frissített vagy törölt sorához. (Öröklődés forrása DbDataAdapter)

esemény

Name	Description
Disposed	Akkor fordul elő, ha az összetevőt a metódus hívása megsemmisíti Dispose() . (Öröklődés forrása Component)
RowUpdated	Az adatforráson végrehajtott parancsok során Update(DataSet) történik. A frissítési kísérlet megtörtént, így az esemény aktiválódik.
RowUpdating	Ez akkor Update(DataSet) fordul elő, amikor egy parancs végrehajtása az adatforráson történik. A frissítési kísérlet megtörtént, így az esemény aktiválódik.

Explicit interfész-implementációk

Name	Description
ICloneable.Clone()	Ennek a tagnak a leírását lásd Clone(): .
IDataAdapter.TableMappings	Lekéri azt a gyűjteményt, amely azt jelzi, hogy egy forrástábla hogyan van leképezve egy adathalmaztáblára. (Öröklődés forrása DataAdapter)
IDbDataAdapter.DeleteCommand	Ennek a tagnak a leírását lásd DeleteCommand: .
IDbDataAdapter.InsertCommand	Ennek a tagnak a leírását lásd InsertCommand: .
IDbDataAdapter.SelectCommand	Ennek a tagnak a leírását lásd SelectCommand: .
IDbDataAdapter.UpdateCommand	Ennek a tagnak a leírását lásd UpdateCommand: .

Lásd még

• Adatadapterek és Adatolvasók
• Adatok (ADO.NET)
• ADO.NET áttekintése