AccessDataSourceView.ExecuteSelect(DataSourceSelectArguments) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Haalt gegevens op uit de onderliggende gegevensopslag met behulp van de SQL-tekenreeks in de SelectCommand eigenschap en eventuele parameters in de SelectParameters verzameling.
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
Parameters
- arguments
- DataSourceSelectArguments
Een DataSourceSelectArguments die wordt gebruikt om bewerkingen op de gegevens aan te vragen die verder gaan dan het ophalen van basisgegevens.
Retouren
Een IEnumerable van de gegevensrijen.
Uitzonderingen
De DataFile eigenschap is null of een lege tekenreeks ("").
De arguments doorgegeven methode geeft aan ExecuteSelect(DataSourceSelectArguments) dat de gegevensbron wat extra werk moet uitvoeren tijdens het ophalen van gegevens om paging of sortering door de opgehaalde gegevens mogelijk te maken, maar het besturingselement voor gegevensbronnen biedt geen ondersteuning voor de aangevraagde mogelijkheid.
Opmerkingen
Het AccessDataSourceView object overschrijft de ExecuteSelect methode om ervoor te zorgen dat de eigenschap van het DataFile bijbehorende AccessDataSource besturingselement is ingesteld voordat gegevens worden opgehaald.
Voordat de ExecuteSelect methode wordt uitgevoerd, wordt de OnSelecting methode aangeroepen om de Selecting gebeurtenis te genereren. U kunt de Selecting gebeurtenis afhandelen om de waarden van de parameters te onderzoeken en eventuele voorverwerkingen uit te voeren vóór een bewerking voor het ophalen van gegevens.
Om het ophalen van gegevens uit te voeren, bouwt het AccessDataSourceView object een IDbCommand object met behulp van de SelectCommand tekst en eventuele bijbehorende SelectParameters eigenschappen. Vervolgens wordt het AccessDataSourceViewIDbCommand object uitgevoerd op basis van de onderliggende gegevensopslag. Nadat de bewerking is voltooid, wordt de OnSelected methode aangeroepen om de Selected gebeurtenis te genereren. U kunt de Selected gebeurtenis afhandelen om alle retourwaarden en foutcodes te onderzoeken en eventuele naverwerking uit te voeren.
Als de DataSourceMode eigenschap is ingesteld op de DataSet waarde en caching is ingeschakeld, AccessDataSourceView worden gegevens opgehaald uit en opgeslagen in de cache tijdens de bewerking voor het ophalen van gegevens. De cache wordt gemaakt, verwijderd of vernieuwd, op basis van het cachegedrag dat is opgegeven door de combinatie van de CacheDuration en CacheExpirationPolicy eigenschappen.
Als de DataSourceMode eigenschap is ingesteld op de DataSet waarde en een FilterExpression eigenschap is opgegeven, wordt de DataSourceMode eigenschap geëvalueerd samen met eventuele opgegeven FilterParameters eigenschappen en wordt het resulterende filter toegepast op de lijst met gegevens tijdens de Select bewerking.