ObjectDataSourceView Osztály

Definíció

Névtér:: System.Web.UI.WebControls

Szerelvény:: System.Web.dll

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.

Támogatja a ObjectDataSource vezérlőt, és interfészt biztosít az adathoz kötött vezérlők számára az üzleti és adatobjektumokkal végzett adatműveletek elvégzéséhez.

public ref class ObjectDataSourceView : System::Web::UI::DataSourceView, System::Web::UI::IStateManager

public class ObjectDataSourceView : System.Web.UI.DataSourceView, System.Web.UI.IStateManager

type ObjectDataSourceView = class
    inherit DataSourceView
    interface IStateManager

Public Class ObjectDataSourceView
Inherits DataSourceView
Implements IStateManager

Öröklődés: Object

DataSourceView
ObjectDataSourceView

Megvalósítás: IStateManager

Megjegyzések

Az ObjectDataSourceView osztályt elsősorban adatkötésű vezérlők használják, és nem programozható objektumként az oldalkódban.

Az ObjectDataSourceView osztály megvalósítja a vezérlő adatfunkcióit ObjectDataSource , beleértve a nézetállapotban tárolt beállítások rendezését, szűrését és kezelését, beleértve a Select, Update, Delete, és Insert műveleteket, a rendezést, a szűrést és a felügyeletet.

A ObjectDataSourceView rendszer futásidőben létrehoz egy objektumot az ObjectDataSource osztály minden példányához. Az osztálypéldány adatműveleteinek ObjectDataSource hívásait az objektum példánya ObjectDataSourceView kezeli. A lapfejlesztők nem férnek hozzá közvetlenül az ObjectDataSourceView osztály példányához. A vezérlőfejlesztők egyéni adatvezérlőket hozhatnak létre az osztályok és ObjectDataSource az ObjectDataSourceView osztályok kiterjesztésével.

Az ObjectDataSourceView osztály adatműveleteket hajt végre úgy, hogy metódusokat hív meg üzleti vagy adatobjektumokon tükröződés használatával. Futásidőben a ObjectDataSource vezérlő létrehoz egy, a TypeName tulajdonság által azonosított típuspéldányt, majd meghívja az adatművelet megfelelő metódusát. A példányosított objektum nem gyorsítótárazza a memóriában a ObjectDataSourceView. Az objektum minden adatmetódus-híváshoz létrejön és megsemmisül. Ha a metódus static (Shared Visual Basic), a rendszer nem hoz létre példányt, de az adatműveleti metódust továbbra is meghívja a rendszer.

A ObjectDataSourceView vezérlő közvetlenül nem teszi elérhetővé a ObjectDataSource lapfejlesztők számára. Ehelyett a tulajdonságok és metódusok ObjectDataSourceViewa ObjectDataSource . A tulajdonság beállítása például DeleteMethod ObjectDataSourceView a DeleteMethod tulajdonság tulajdonságának ObjectDataSourcebeállításával történik.

Adatok beolvasása

Az adatforrásnézetek legalapvetőbb művelete az adatok lekérése a mögöttes adattárból a Select metódus használatával, amely adatelemek gyűjteményét kéri le IEnumerable . Az objektum a ObjectDataSourceView következő adatlekérési módszereket, tulajdonságokat és eseményeket valósítja meg, és közvetlenül a vezérlője ObjectDataSource teszi elérhetővé a lapfejlesztők és más hívók számára:

A Select metódus
A SelectMethod tulajdonság
A SelectParameters tulajdonság
Az Selecting esemény
Az Selected esemény

Adatok frissítése

Az ObjectDataSourceView objektum a tulajdonság által azonosított üzleti vagy adatobjektum-metódus meghívásával támogatja az adatfrissítéseket UpdateMethod . A frissítéseket automatikusan végrehajtó adatkötésű vezérlők, például a GridView DetailsView vezérlők, egy felületen adják át a paramétereket IOrderedDictionary a ObjectDataSourceView felületnek, és a nézetobjektum egyesíti ezeket a paramétereket a UpdateParameters gyűjteményben található paraméterekkel.

Az alábbi frissítési módszereket, tulajdonságokat és eseményeket az ObjectDataSourceView oldalfejlesztők és más hívók közvetlenül az irányításukkal ObjectDataSource implementálják és teszik közzé:

A Update metódus
A UpdateMethod tulajdonság
A UpdateParameters tulajdonság
Az Updating esemény
Az Updated esemény

Adatok beszúrása

Az ObjectDataSourceView objektum a tulajdonság által azonosított üzleti vagy adatobjektum-metódus meghívásával támogatja az új adatsorok beszúrását InsertMethod . A beszúrásokat automatikusan végrehajtó adatkötésű vezérlők, például az GridView és DetailsView, adják át a paramétereket egy IOrderedDictionary felületen, ObjectDataSourceView és a nézetobjektum egyesíti ezeket a paramétereket a InsertParameters gyűjteményben található paraméterekkel.

A következő beszúrási módszereket, tulajdonságokat és eseményeket az ObjectDataSourceView oldalfejlesztők és más hívók közvetlenül az irányításukkal ObjectDataSource implementálják és teszik közzé:

A Insert metódus
A InsertMethod tulajdonság
A InsertParameters tulajdonság
Az Inserting esemény
Az Inserted esemény

Adatok törlése

Az ObjectDataSourceView objektum a tulajdonság által azonosított üzleti vagy adatobjektum-metódus meghívásával támogatja az adatok törlését DeleteMethod . A törléseket automatikusan végrehajtó adatkötésű vezérlők, például az GridView és DetailsView, a paramétereket egy IOrderedDictionary felületen adják át a ObjectDataSourceView rendszernek, és a nézetobjektum egyesíti ezeket a paramétereket a DeleteParameters gyűjteményben található paraméterekkel. A következő törlési módszereket, tulajdonságokat és eseményeket az ObjectDataSourceView oldalfejlesztők és más hívók közvetlenül az irányításukkal ObjectDataSource implementálják és teszik közzé:

A Delete metódus
A DeleteMethod tulajdonság
A DeleteParameters tulajdonság
Az Deleting esemény
Az Deleted esemény

Adatok szűrése és rendezése

Az adatlekérés hatékonyabb, ha dinamikusan szűrheti az adatokat. A szűrést csak akkor támogatja a ObjectDataSource vezérlő, ha a Select metódus egy vagy DataTable objektumot DataSet ad vissza. A FilterExpression tulajdonságok használatával FilterParameters dinamikus szűrést alkalmazhat az adatlekérésre. Ezeket a tulajdonságokat az ObjectDataSourceView objektum valósítja meg, és közvetlenül a vezérlője ObjectDataSource teszi elérhetővé az adatkötött vezérlők és más hívók számára.

A lekért ObjectDataSource adatokat úgy rendezheti, hogy a lekérés után a memóriában rendezi az adatokat. A rendezést csak akkor támogatja a ObjectDataSource vezérlő, ha a Select metódus egy DataTable vagy DataSet. A CanSort tulajdonság mindig visszaad, truemert a ObjectDataSourceView metódus nem tudja meghatározni, hogy a Select metódus milyen típust ad vissza a metódus meghívása nélkül. A SortExpression tulajdonság szintaxisa megegyezik egy DataView.Sort tulajdonság szintaxisával.

Nyomkövetési nézet állapota

A ObjectDataSourceView felület implementálása és IStateManager a nézetállapot használatával nyomon követi az állapotát az oldalkérések között. A , LoadViewStateés SaveViewState metódusok implementálása TrackViewStatelehetővé teszi a vezérlőelem állapotkövetésének megtekintését. További információ: ASP.NET Állapotkezelés áttekintése.

Konstruktorok

Name	Description
ObjectDataSourceView(ObjectDataSource, String, HttpContext)	Inicializálja a ObjectDataSourceView osztály új példányát.

Tulajdonságok

Name	Description
CanDelete	Beolvas egy értéket, amely jelzi, hogy az ObjectDataSourceView aktuális ObjectDataSource vezérlőhöz társított objektum támogatja-e a törlési műveletet.
CanInsert	Beolvas egy értéket, amely jelzi, hogy az ObjectDataSourceView aktuális ObjectDataSource vezérlőhöz társított objektum támogatja-e a beszúrási műveletet.
CanPage	Beolvas egy értéket, amely jelzi, hogy az ObjectDataSourceView aktuális ObjectDataSource vezérlőhöz társított objektum támogatja-e a beolvasott adatok lapozását.
CanRetrieveTotalRowCount	Egy értéket kap, amely jelzi, hogy az ObjectDataSourceView aktuális ObjectDataSource vezérlőhöz társított objektum támogatja-e az adatsorok teljes számának lekérését az adatkészlet mellett.
CanSort	Beolvas egy értéket, amely jelzi, hogy az ObjectDataSourceView aktuális ObjectDataSource vezérlőhöz társított objektum támogatja-e a rendezett nézetet az alapul szolgáló adatforráson.
CanUpdate	Beolvas egy értéket, amely jelzi, hogy az ObjectDataSourceView aktuális ObjectDataSource vezérlőhöz társított objektum támogatja-e a frissítési műveletet.
ConflictDetection	Lekéri vagy beállít egy értéket, amely meghatározza, hogy a vezérlő hogyan hajtja végre a ObjectDataSource frissítéseket és a törléseket, amikor a mögöttes adattár egy sorában lévő adatok megváltoznak a művelet ideje alatt.
ConvertNullToDBNull	Lekéri vagy beállít egy értéket, amely jelzi, hogy a frissítési, beszúrási vagy törlési műveletnek átadott értékek automatikusan az értékre Parameter`null` lesznek-e Value konvertálva.
DataObjectTypeName	Lekéri vagy beállítja annak az osztálynak a nevét, amelyet a ObjectDataSource vezérlő egy adatművelet egy paraméteréhez használ. A ObjectDataSource vezérlő a megadott osztályt használja a Parameter különböző paramétergyűjteményekben található objektumok helyett.
DeleteMethod	Lekéri vagy beállítja annak a metódusnak vagy függvénynek a nevét, amelyet az objektum meghív az ObjectDataSourceView adatok törléséhez.
DeleteParameters	Lekéri a metódus által használt paramétereket tartalmazó paramétergyűjteményt DeleteMethod .
EnablePaging	Lekéri vagy beállít egy értéket, amely jelzi, hogy az adatforrás-vezérlő támogatja-e a lekért adatkészlet lapozását.
Events	Lekéri az adatforrás nézet eseménykezelő delegáltjainak listáját. (Öröklődés forrása DataSourceView)
FilterExpression	Lekéri vagy beállítja a tulajdonság által SelectMethod azonosított üzleti objektum metódus meghívásakor alkalmazott szűrőkifejezést.
FilterParameters	Lekéri a sztringben található paraméterhelyőrzőkhöz társított paraméterek gyűjteményét FilterExpression .
InsertMethod	Lekéri vagy beállítja annak a metódusnak vagy függvénynek a nevét, amelyet az ObjectDataSourceView objektum meghív az adatok beszúrásához.
InsertParameters	Lekéri a metódus által használt paramétereket tartalmazó paramétergyűjteményt InsertMethod .
IsTrackingViewState	Beolvas egy értéket, amely jelzi, hogy az ObjectDataSourceView objektum menti-e a nézetállapot módosításait.
MaximumRowsParameterName	Lekéri vagy beállítja annak az adatlekérési metódusparaméternek a nevét, amely az adatforrás lapozási támogatásához beolvasandó rekordok számát jelzi.
Name	Lekéri az adatforrás nézet nevét. (Öröklődés forrása DataSourceView)
OldValuesParameterFormatString	Lekéri vagy beállít egy formátumsztringet, amely az eredeti értékeknek a metódusoknak átadott `DeleteUpdate` paraméterek nevére vonatkozik.
ParsingCulture	Lekéri vagy beállít egy értéket, amely azt jelzi, hogy milyen kulturális információk használhatók a sztringértékek tényleges tulajdonságtípusokká alakításakor, hogy létrehozhasson egy objektumot az általuk jelzett típusból DataObjectTypeName.
SelectCountMethod	Lekéri vagy beállítja annak a metódusnak vagy függvénynek a nevét, amelyet a ObjectDataSourceView vezérlőelem meghív a sorok számának lekéréséhez.
SelectMethod	Lekéri vagy beállítja annak a metódusnak vagy függvénynek a nevét, amelyet a vezérlő meghív az ObjectDataSourceView adatok lekéréséhez.
SelectParameters	Lekéri a metódus által használt paramétereket tartalmazó paramétergyűjteményt SelectMethod .
SortParameterName	Lekéri vagy beállítja annak az adatlekérési metódusparaméternek a nevét, amely az adatforrás-rendezési támogatáshoz tartozó rendezési kifejezés megadására szolgál.
StartRowIndexParameterName	Lekéri vagy beállítja annak az adatlekérési metódusparaméternek a nevét, amely az adatforrás lapozási támogatásának eredménykészletéből lekérendő első rekord egész számindexét jelzi.
TypeName	Lekéri vagy beállítja annak az osztálynak a nevét, amelyet a ObjectDataSource vezérlő jelöl.
UpdateMethod	Lekéri vagy beállítja annak a metódusnak vagy függvénynek a nevét, amelyet az objektum meghív az ObjectDataSourceView adatok frissítéséhez.
UpdateParameters	Lekéri a metódus által használt paramétereket tartalmazó paramétergyűjteményt UpdateMethod .

Metódusok

Name	Description
CanExecute(String)	Meghatározza, hogy a megadott parancs végrehajtható-e. (Öröklődés forrása DataSourceView)
Delete(IDictionary, IDictionary, DataSourceViewOperationCallback)	Aszinkron törlési műveletet hajt végre az objektum által DataSourceView képviselt adatok listáján. (Öröklődés forrása DataSourceView)
Delete(IDictionary, IDictionary)	Törlési műveletet hajt végre a tulajdonság által DeleteMethod a megadott `keys` és `oldValues` gyűjtemények használatával azonosított üzleti objektum metódus meghívásával.
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
ExecuteCommand(String, IDictionary, IDictionary, DataSourceViewOperationCallback)	Végrehajtja a megadott parancsot. (Öröklődés forrása DataSourceView)
ExecuteCommand(String, IDictionary, IDictionary)	Végrehajtja a megadott parancsot. (Öröklődés forrása DataSourceView)
ExecuteDelete(IDictionary, IDictionary)	Törlési műveletet hajt végre a metódus és a DeleteMethod megadott `keys` és `oldValues` gyűjtemény használatával.
ExecuteInsert(IDictionary)	Beszúrási műveletet hajt végre a tulajdonság által InsertMethod a megadott `values` gyűjtemény használatával azonosított üzleti objektum metódus meghívásával.
ExecuteSelect(DataSourceSelectArguments)	A tulajdonság által TypeName azonosított objektum adatainak lekérése a tulajdonság által azonosított metódus meghívásával és a SelectMethod gyűjtemény értékeinek SelectParameters átadásával.
ExecuteUpdate(IDictionary, IDictionary, IDictionary)	Frissítési műveletet hajt végre a tulajdonság által azonosított metódus meghívásával és a UpdateMethod , `keys`vagy `values` gyűjteményekben `oldValues`megadott paraméterek használatával.
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
Insert(IDictionary, DataSourceViewOperationCallback)	Aszinkron beszúrási műveletet hajt végre az objektum által képviselt adatok DataSourceView listájában. (Öröklődés forrása DataSourceView)
Insert(IDictionary)	Beszúrási műveletet hajt végre a tulajdonság által InsertMethod a megadott `values` gyűjtemény használatával azonosított üzleti objektum metódus meghívásával.
LoadViewState(Object)	Visszaállítja az adatforrásnézet korábban mentett nézetállapotát.
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
OnDataSourceViewChanged(EventArgs)	Az eseményt emeli DataSourceViewChanged ki. (Öröklődés forrása DataSourceView)
OnDeleted(ObjectDataSourceStatusEventArgs)	Az eseményt azután emeli ki, Deleted hogy az ObjectDataSourceView objektum végrehajtott egy törlési műveletet.
OnDeleting(ObjectDataSourceMethodEventArgs)	Mielőtt az Deleting ObjectDataSourceView objektum törlési műveletet kísérel meg, elővesz egy eseményt.
OnFiltering(ObjectDataSourceFilteringEventArgs)	Az eseményt még Filtering azelőtt aktiválja, hogy az ObjectDataSourceView objektum szűrési műveletet kísérel meg.
OnInserted(ObjectDataSourceStatusEventArgs)	Az eseményt azután emeli ki, Inserted hogy az ObjectDataSourceView objektum végrehajtott egy beszúrási műveletet.
OnInserting(ObjectDataSourceMethodEventArgs)	Az eseményt az Inserting objektum beszúrási műveletének megkísérlése előtt ObjectDataSourceView emeli ki.
OnObjectCreated(ObjectDataSourceEventArgs)	Az eseményt azután ObjectCreated hozza létre, hogy a ObjectDataSourceView tulajdonság azonosítja az objektum egy példányát TypeName .
OnObjectCreating(ObjectDataSourceEventArgs)	Az eseményt azelőtt állítja elő, ObjectCreating hogy az ObjectDataSourceView objektum létrehoz egy üzleti objektumpéldányt egy adatművelet végrehajtásához.
OnObjectDisposing(ObjectDataSourceDisposingEventArgs)	Az eseményt azelőtt hozza létre, ObjectDisposing hogy az ObjectDataSourceView objektum elvet egy példányosított típust.
OnSelected(ObjectDataSourceStatusEventArgs)	Az eseményt azután Selected emeli ki, hogy az ObjectDataSourceView objektum végrehajtott egy adatlekérési műveletet.
OnSelecting(ObjectDataSourceSelectingEventArgs)	Mielőtt az Selecting ObjectDataSourceView objektum adatlekérési műveletet kísérel meg, elővesz egy eseményt.
OnUpdated(ObjectDataSourceStatusEventArgs)	Az eseményt azután emeli ki, Updated hogy az ObjectDataSourceView objektum végrehajtott egy frissítési műveletet.
OnUpdating(ObjectDataSourceMethodEventArgs)	Az eseményt még Updating azelőtt aktiválja, hogy az ObjectDataSourceView objektum frissítési műveletet kísérel meg.
RaiseUnsupportedCapabilityError(DataSourceCapabilities)	A metódus meghívta, RaiseUnsupportedCapabilitiesError(DataSourceView) hogy hasonlítsa össze a művelethez ExecuteSelect(DataSourceSelectArguments) kért képességeket azokkal, amelyeket a nézet támogat. (Öröklődés forrása DataSourceView)
SaveViewState()	Menti az objektum nézetállapotának ObjectDataSourceView módosításait a lap kiszolgálóra való visszakerülése óta.
Select(DataSourceSelectArguments, DataSourceViewSelectCallback)	A mögöttes adattárból aszinkron módon lekéri az adatok listáját. (Öröklődés forrása DataSourceView)
Select(DataSourceSelectArguments)	A tulajdonság által TypeName azonosított objektum adatainak lekérése a tulajdonság által azonosított metódus meghívásával és a SelectMethod gyűjtemény értékeinek SelectParameters átadásával.
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)
TrackViewState()	Ez azt eredményezi, hogy az ObjectDataSourceView objektum nyomon követi a nézetállapot változásait, hogy a módosítások a vezérlő objektumában ViewState tárolhatók legyenek, és ugyanazon lap kérései között megmaradjanak.
Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)	Aszinkron frissítési műveletet hajt végre az objektum által képviselt adatok DataSourceView listáján. (Öröklődés forrása DataSourceView)
Update(IDictionary, IDictionary, IDictionary)	Frissítési műveletet hajt végre a tulajdonság által azonosított metódus meghívásával és a UpdateMethod , `keys`vagy `values` gyűjteményekben `oldValues`megadott paraméterek használatával.

esemény

Name	Description
DataSourceViewChanged	Akkor fordul elő, ha az adatforrás nézete megváltozott. (Öröklődés forrása DataSourceView)
Deleted	A művelet befejezésekor Delete következik be.
Deleting	Művelet előtt Delete következik be.
Filtering	Szűrőművelet előtt következik be.
Inserted	Akkor fordul elő, ha egy Insert művelet befejeződött.
Inserting	Művelet előtt Insert következik be.
ObjectCreated	Azután következik be, hogy az ObjectDataSourceView objektum létrehoz egy, a tulajdonság által azonosított típusú példányt TypeName .
ObjectCreating	Mielőtt az ObjectDataSourceView objektum létrehoz egy, a tulajdonság által azonosított típusú példányt TypeName .
ObjectDisposing	Ez akkor fordul elő, ha az ObjectDataSourceView objektum elveti az általa létrehozott objektum egy példányát.
Selected	Akkor fordul elő, ha egy adatlekérési művelet befejeződött.
Selecting	Adatlekérési művelet előtt történik.
Updated	Akkor fordul elő, ha egy Update művelet befejeződött.
Updating	Művelet előtt Update következik be.

Explicit interfész-implementációk

Name	Description
IStateManager.IsTrackingViewState	Ennek a tagnak a leírását lásd IsTrackingViewState: .
IStateManager.LoadViewState(Object)	Ennek a tagnak a leírását lásd LoadViewState(Object): .
IStateManager.SaveViewState()	Ennek a tagnak a leírását lásd SaveViewState(): .
IStateManager.TrackViewState()	Ennek a tagnak a leírását lásd TrackViewState(): .

A következőre érvényes:

Lásd még

Visszajelzés

Hasznosnak találta ezt az oldalt?