Nyelv

AccessDataSourceView.ExecuteSelect(DataSourceSelectArguments) Metódus

Definíció

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.

A következőre érvényes:

Lásd még