AccessDataSourceView.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.
Adatokat kér le a mögöttes adattárból a tulajdonság SQL-sztringje SelectCommand és a gyűjtemény bármely paramétere SelectParameters alapján.
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.IEnumerable
Protected Friend Overrides Function ExecuteSelect (arguments As DataSourceSelectArguments) As IEnumerable
Paraméterek
- arguments
- DataSourceSelectArguments
Az DataSourceSelectArguments alapszintű adatlekérésen túl az adatokon végzett műveletek igénylésére használható.
Válaszok
Adatsorok IEnumerable egyike.
Kivételek
A DataFile tulajdonság vagy null egy üres sztring ("").
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.
Megjegyzések
Az AccessDataSourceView objektum felülbírálja a ExecuteSelect metódust, hogy DataFile az adatok beolvasása előtt a társított AccessDataSource vezérlő tulajdonsága be legyen állítva.
A metódus végrehajtása előtt a ExecuteSelect rendszer meghívja a OnSelecting metódust az Selecting esemény felemelésére. Az eseményt kezelheti a Selecting paraméterek értékeinek vizsgálatához és az adatlekérési művelet előtti előfeldolgozáshoz.
Az adatlekérés végrehajtásához az AccessDataSourceView objektum egy IDbCommand objektumot hoz létre a szöveg és a SelectCommand kapcsolódó SelectParameters tulajdonságok használatával. Ezután az AccessDataSourceView objektum végrehajtja az IDbCommand objektumot a mögöttes adattáron. A művelet befejezése után a rendszer meghívja a OnSelected metódust az Selected esemény felemelésére. Az eseményt kezelheti a visszatérési Selected értékek és hibakódok vizsgálatához, valamint az utólagos feldolgozáshoz.
Ha a DataSourceMode tulajdonság az értékre DataSet van állítva, és a gyorsítótárazás engedélyezve van, a rendszer lekéri az AccessDataSourceView adatokat, és az adatokat a gyorsítótárba menti az adatlekérési művelet során. 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 DataSourceMode tulajdonság értékre DataSet van állítva, és egy FilterExpression tulajdonság van megadva, a rendszer kiértékeli a DataSourceMode tulajdonságot a megadott FilterParameters tulajdonságokkal együtt, és az eredményül kapott szűrőt alkalmazza a művelet során az Select adatok listájára.