ObjectDataSource.Select 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 door de methode aan te roepen die wordt geïdentificeerd door de SelectMethod eigenschap met de parameters in de SelectParameters verzameling.
public:
System::Collections::IEnumerable ^ Select();public System.Collections.IEnumerable Select();member this.Select : unit -> System.Collections.IEnumerablePublic Function Select () As IEnumerableRetouren
Een IEnumerable lijst met gegevensrijen.
Voorbeelden
Zie ObjectDataSourcevoor een codevoorbeeld.
Opmerkingen
De opgegeven methode kan een methodehandtekening hebben, maar deze moet worden geretourneerd of afgeleid van een van de typen die in de volgende tabel worden vermeld, zodat het ObjectDataSource besturingselement deze kan aanroepen.
| 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. |
| DataView | De DataView waarde wordt geretourneerd door de 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 verzameling met één element IEnumerable en geretourneerd door de Select methode. |
De methode die wordt geïdentificeerd door de eigenschap SelectMethod kan een instantiemethode of een methode static (Shared in Visual Basic) zijn. Als het een instantiemethode is, wordt het bedrijfsobject gemaakt en vernietigd telkens wanneer de methode die is opgegeven door de SelectMethod eigenschap wordt aangeroepen, behalve dat hetzelfde exemplaar wordt gebruikt om de methode aan te roepen die is opgegeven door de SelectMethod eigenschap en de methode die door de SelectCountMethod eigenschap is opgegeven. De Select methode retourneert een IEnumerable interface. Als u echter caching- en filterscenario's wilt inschakelen, moet de retourwaarde een DataSet object zijn. Hoewel de DataSet klasse de IEnumerable interface niet implementeert, extraheert het ObjectDataSource besturingselement automatisch het standaard DataView besturingselement, waarmee het IEnumerablewordt geïmplementeerd.
Voordat de Select bewerking 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 vóór een Select bewerking uit te voeren. Als u een bewerking voor het ophalen van gegevens wilt uitvoeren, gebruikt het ObjectDataSourceView object weerspiegeling om een exemplaar te maken van het object dat wordt geïdentificeerd door de TypeName eigenschap. Vervolgens wordt de methode aangeroepen die wordt geïdentificeerd door de SelectMethod eigenschap, met behulp van eventuele gekoppelde SelectParameters eigenschappen. Nadat de Select bewerking is voltooid, wordt de OnSelected methode aangeroepen om de Selected gebeurtenis te genereren. U kunt de Selected gebeurtenis afhandelen om eventuele retourwaarden, uitvoerparameters en uitzonderingen te onderzoeken en om eventuele naverwerking uit te voeren.
Als de SelectMethod eigenschap een DataSet, DataTableof DataView object en caching retourneert, ObjectDataSource worden gegevens opgehaald uit en opgeslagen in de cache tijdens de Select 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 SelectMethod eigenschap een DataSet of DataTable object retourneert en er een FilterExpression eigenschap is opgegeven, wordt deze geëvalueerd met opgegeven FilterParameters eigenschappen en wordt het resulterende filter toegepast op de lijst met gegevens tijdens de Select bewerking.
De Select methode delegeert aan de Select methode van de ObjectDataSourceView methode die is gekoppeld aan het ObjectDataSource besturingselement.
Zie voor meer informatie over het samenvoegen van parameters, de levensduur van objecten en methodeomzetting SelectMethod.
besturingselementen voor Data-Bound
Wanneer het ObjectDataSource besturingselement is gekoppeld aan een gegevensgebonden besturingselement, zoals het GridView besturingselement, is het niet nodig om de Select methode aan te roepen vanuit paginacode. De Select methode wordt rechtstreeks aangeroepen door het gegevensgebonden besturingselement.