ObjectDataSourceView.ExecuteSelect(DataSourceSelectArguments) Metódus
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.
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.
protected public:
override System::Collections::IEnumerable ^ ExecuteSelect(System::Web::UI::DataSourceSelectArguments ^ arguments);protected internal override System.Collections.IEnumerable ExecuteSelect(System.Web.UI.DataSourceSelectArguments arguments);override this.ExecuteSelect : System.Web.UI.DataSourceSelectArguments -> System.Collections.IEnumerableProtected Friend Overrides Function ExecuteSelect (arguments As DataSourceSelectArguments) As IEnumerableParaméterek
- arguments
- DataSourceSelectArguments
Az DataSourceSelectArguments adatokon az alapszintű adatlekérésen túli műveletek igénylésére szolgál.
Válaszok
Adatsorok IEnumerable listája.
Kivételek
Az arguments átadott ExecuteSelect(DataSourceSelectArguments) metódus azt határozza meg, hogy az adatforrásnak további munkát kell végeznie az adatok beolvasása közben, hogy lehetővé tegye a lapozást vagy a beolvasott adatok szerinti rendezést, de az adatforrás-vezérlő nem támogatja a kért képességet.
-vagy-
A metódus által ExecuteSelect(DataSourceSelectArguments) visszaadott objektum nem DataSet a vagy DataTable, és a gyorsítótárazás engedélyezve van. Csak DataSet és DataTable objektumok gyorsítótárazhatók a ObjectDataSourceView vezérlőhöz.
-vagy-
A gyorsítótárazás és az ügyfél-megszemélyesítés is engedélyezve van. Ez ObjectDataSource nem támogatja a gyorsítótárazást, ha az ügyfél megszemélyesítése engedélyezve van.
A metódus által visszaadott ExecuteSelect(DataSourceSelectArguments) objektum egy DataSet, de a gyűjteményében Tables nincsenek táblák.
-vagy-
A EnablePaging tulajdonság értéke true, de a StartRowIndexParameterName tulajdonságok nincsenek MaximumRowsParameterName beállítva.
Megjegyzések
Az ObjectDataSourceView osztály implementálja az örökölt metódust ExecuteSelect az adatok üzleti objektum használatával való lekéréséhez. A lapfejlesztők és az adathoz kötött vezérlők nem hívják meg közvetlenül a ExecuteSelect metódust, hanem a nyilvánosan közzétett Select metódust használják.
A megadott metódus bármilyen metódus-aláírással rendelkezhet, de a sikeres meghíváshoz az alábbi táblázatban felsorolt vezérlőtípusok ObjectDataSource egyikét kell visszaadnia.
| Visszatérési típus | Action |
|---|---|
| IEnumerable | A IEnumerable metódus visszaadja a függvényt Select . |
| DataTable | Az A DataView a metódussal DataTable jön létre, és visszaadja.Select |
| DataSet | Az első ki DataTable lesz nyerve, és a DataSet metódus létrehozza és visszaadja az egyiket DataViewSelect. |
| Object | Az objektum egy elembe IEnumerable van csomagolva, és a Select metódus adja vissza. |
Az adatlekérés végrehajtása előtt a rendszer meghívja a OnSelecting metódust az Selecting esemény felemelésére. Ezt az eseményt kezelheti a paraméterek értékeinek vizsgálatához és a művelet előtti előfeldolgozáshoz.
A kijelölési művelet végrehajtásához a ObjectDataSourceView vezérlő tükröződés segítségével meghívja a tulajdonság és a SelectMethodSelectParameters gyűjteményben található társított paraméterek által azonosított metódust, majd végrehajtja azt. A művelet befejezése után a rendszer meghívja a OnSelected metódust az Selected esemény felemelésére. Ezt az eseményt kezelheti a visszatérési értékek és hibakódok vizsgálatához, valamint az utólagos feldolgozáshoz.
Ha a Select metódus egy DataSet objektumot ad vissza, és a gyorsítótárazás engedélyezve van, a művelet során a ObjectDataSourceView rendszer adatokat kér le és ment a gyorsítótárba. A gyorsítótár létrehozása, elvetése vagy frissítése a gyorsítótár és CacheDuration a tulajdonságok kombinációja CacheExpirationPolicy által megadott gyorsítótárazási viselkedés alapján történik.
Ha a Select metódus egy DataSet objektumot és egy FilterExpression tulajdonságot ad FilterParameters vissza, a rendszer kiértékeli a megadott tulajdonságokat, és az eredményül kapott szűrőt alkalmazza a rendszer az adatok listájára a Select művelet során.
A kijelölt sorok számának visszaadásával kapcsolatos információkért lásd: Select.
