ObjectDataSourceView.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.
Hiermee worden gegevens opgehaald uit het object dat wordt geïdentificeerd door de TypeName eigenschap door de methode aan te roepen die wordt geïdentificeerd door de SelectMethod eigenschap en eventuele waarden in de SelectParameters verzameling door te geven.
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 IEnumerableParameters
- arguments
- DataSourceSelectArguments
Een DataSourceSelectArguments bewerking die wordt gebruikt om bewerkingen op de gegevens aan te vragen die verder gaan dan het ophalen van basisgegevens.
Retouren
Een IEnumerable lijst met gegevensrijen.
Uitzonderingen
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.
– of –
Het object dat door de ExecuteSelect(DataSourceSelectArguments) methode wordt geretourneerd, is geen DataSet of DataTable, en caching is ingeschakeld. Alleen DataSet en DataTable objecten kunnen in de cache worden opgeslagen voor het ObjectDataSourceView besturingselement.
– of –
Zowel caching als clientimitatie zijn ingeschakeld. Caching ObjectDataSource wordt niet ondersteund wanneer clientimitatie is ingeschakeld.
Het object dat door de ExecuteSelect(DataSourceSelectArguments) methode wordt geretourneerd, is een DataSet, maar bevat geen tabellen in de Tables verzameling.
– of –
De EnablePaging eigenschap is ingesteld op true, maar de StartRowIndexParameterName eigenschappen MaximumRowsParameterName zijn niet ingesteld.
Opmerkingen
De ObjectDataSourceView klasse implementeert de overgenomen ExecuteSelect methode om gegevens op te halen met behulp van een bedrijfsobject. Paginaontwikkelaars en auteurs van gegevensgebonden besturingselementen roepen de ExecuteSelect methode niet rechtstreeks aan. Gebruik in plaats daarvan de openbaar weergegeven Select methode.
De opgegeven methode kan elke methodehandtekening hebben, maar moet een van de typen retourneren voor het ObjectDataSource besturingselement dat wordt vermeld in de volgende tabel om het aan te roepen.
| Terugbrengtype | Action |
|---|---|
| IEnumerable | De IEnumerable waarde wordt geretourneerd door de Select methode. |
| DataTable | Er wordt een DataView gemaakt met behulp van de DataTable en geretourneerde Select methode. |
| DataSet | De eerste DataTable is DataSet geëxtraheerd en er wordt een DataView gemaakt en geretourneerd door de Select methode. |
| Object | Het object wordt verpakt in een één element IEnumerable en geretourneerd door de Select methode. |
Voordat het ophalen van gegevens wordt uitgevoerd, wordt de OnSelecting methode aangeroepen om de Selecting gebeurtenis te genereren. U kunt deze gebeurtenis afhandelen om de waarden van de parameters te onderzoeken en eventuele voorverwerkingen vóór een bewerking uit te voeren.
Als u een selectiebewerking wilt uitvoeren, gebruikt het ObjectDataSourceView besturingselement weerspiegeling om de methode aan te roepen die wordt geïdentificeerd door de SelectMethod eigenschap en eventuele bijbehorende parameters die zich in de SelectParameters verzameling bevinden en vervolgens wordt uitgevoerd. Nadat de bewerking is voltooid, wordt de OnSelected methode aangeroepen om de Selected gebeurtenis te genereren. U kunt deze gebeurtenis afhandelen om eventuele retourwaarden en foutcodes te onderzoeken en eventuele naverwerking uit te voeren.
Als de Select methode een DataSet object retourneert en caching is ingeschakeld, ObjectDataSourceView worden gegevens opgehaald uit en opgeslagen in de cache tijdens de bewerking. 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 Select methode een DataSet object retourneert en er een FilterExpression eigenschap is opgegeven, wordt deze geëvalueerd, samen met eventuele opgegeven FilterParameters eigenschappen en wordt het resulterende filter toegepast op de lijst met gegevens tijdens de Select bewerking.
Zie voor meer informatie over het retourneren van het aantal geselecteerde Selectrijen.