DataAdapter Osztály
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Sql-parancsok halmazát és adatbázis-kapcsolatot jelöl, amelyek az DataSet adatforrás kitöltésére és frissítésére szolgálnak.
public ref class DataAdapter : System::ComponentModel::Component, System::Data::IDataAdapter
public ref class DataAdapter abstract : System::ComponentModel::Component, System::Data::IDataAdapter
[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)]
public class DataAdapter : System.ComponentModel.Component, System.Data.IDataAdapter
public class DataAdapter : System.ComponentModel.Component, System.Data.IDataAdapter
public abstract class DataAdapter : System.ComponentModel.Component, System.Data.IDataAdapter
[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)>]
type DataAdapter = class
inherit Component
interface IDataAdapter
type DataAdapter = class
inherit Component
interface IDataAdapter
Public Class DataAdapter
Inherits Component
Implements IDataAdapter
Public MustInherit Class DataAdapter
Inherits Component
Implements IDataAdapter
- Öröklődés
- Származtatott
- Attribútumok
- Megvalósítás
Megjegyzések
Ez DataAdapter hídként szolgál egy DataSet és egy adatforrás között az adatok lekéréséhez és mentéséhez. Ezt DataAdapter a hidat leképezéssel Fillbiztosítja, amely az adatforrásban lévő adatoknak megfelelően módosítja a benne DataSet lévő adatokat, és Updateamely az adatforrásban lévő adatokat úgy módosítja, hogy azok megegyeznek az DataSetadatforrásban lévő adatokkal.
Ha SQL Server adatbázishoz csatlakozik, a SqlDataAdapter és a hozzá tartozó SqlCommand és SqlConnection objektumok használatával növelheti a teljesítményt. Az OLE DB által támogatott adatforrások esetében használja a DataAdapter társított OleDbCommand és OleDbConnection az objektumokat. Az ODBC által támogatott adatforrások esetében használja a DataAdapter társított OdbcCommand és OdbcConnection az objektumokat. Oracle-adatbázisok esetén használja a DataAdapter társított OracleCommand és OracleConnection az objektumokat.
Amikor létrejön egy példány DataAdapter , az olvasási/írási tulajdonságok kezdeti értékekre vannak állítva. Ezeknek az értékeknek a listáját a konstruktorban DataAdapter találja.
Konstruktorok
| Name | Description |
|---|---|
| DataAdapter() |
Inicializálja a DataAdapter osztály új példányát. |
| DataAdapter(DataAdapter) |
Inicializálja az DataAdapter osztály új példányát egy azonos típusú meglévő objektumból. |
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. |
| AcceptChangesDuringUpdate |
Lekérdezi vagy beállítja, hogy a rendszer meghívja-e AcceptChanges() egy Update(DataSet). |
| 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. |
| 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) |
| 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. |
| MissingMappingAction |
Meghatározza, hogy milyen műveletet kell elvégezni, ha a bejövő adatok nem rendelkeznek egyező táblával vagy oszloppal. |
| MissingSchemaAction |
Meghatározza a végrehajtandó műveletet, ha a meglévő DataSet séma nem egyezik a bejövő adatokkal. |
| ReturnProviderSpecificTypes |
Lekérdezi vagy beállítja, hogy a metódusnak |
| 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. |
Metódusok
| Name | Description |
|---|---|
| CloneInternals() |
Elavult.
Elavult.
Elavult.
Elavult.
Létrehozza a példány másolatát 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) |
| CreateTableMappings() |
Létrehoz egy újat DataTableMappingCollection. |
| 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 DataAdapter használt nem felügyelt erőforrásokat, és opcionálisan felszabadítja a felügyelt erőforrásokat. |
| Equals(Object) |
Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object) |
| Fill(DataSet, String, IDataReader, Int32, Int32) |
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. |
| Fill(DataSet) |
Sorokat ad hozzá vagy frissít az DataSet adatforrásban lévőknek megfelelően. |
| Fill(DataTable, IDataReader) |
Sorokat ad hozzá vagy frissít az DataTable adatforrásban lévőkkel a név és a DataTable megadott IDataReadernév alapján. |
| 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. |
| FillSchema(DataSet, SchemaType, String, IDataReader) | |
| FillSchema(DataSet, SchemaType) |
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. |
| FillSchema(DataTable, SchemaType, IDataReader) | |
| GetFillParameters() |
Lekéri a felhasználó által az SQL SELECT utasítás végrehajtásakor beállított paramétereket. |
| GetHashCode() |
Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object) |
| GetLifetimeService() |
Elavult.
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 |
| InitializeLifetimeService() |
Elavult.
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) |
| OnFillError(FillErrorEventArgs) |
Meghívva, amikor hiba történik egy |
| ResetFillLoadOption() |
Alaphelyzetbe állítja FillLoadOption az alapértelmezett állapotát, és a tisztelet Fill(DataSet)okaitAcceptChangesDuringFill. |
| ShouldSerializeAcceptChangesDuringFill() |
Meghatározza, hogy a AcceptChangesDuringFill tulajdonságot meg kell-e őrizni. |
| ShouldSerializeFillLoadOption() |
Meghatározza, hogy a FillLoadOption tulajdonságot meg kell-e őrizni. |
| ShouldSerializeTableMappings() |
Meghatározza, hogy létezik-e egy vagy több DataTableMapping objektum, és meg kell-e őrizni őket. |
| 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(DataSet) |
Meghívja a megfelelő INSERT, UPDATE vagy DELETE utasítást az egyes beszúrt, frissített vagy törölt sorokhoz a megadott DataSet "Tábla" nevű sorhoz DataTable . |
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) |
| FillError |
Akkor jelenik meg, ha hiba történik egy kitöltési művelet során. |
Explicit interfész-implementációk
| Name | Description |
|---|---|
| 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. |