ObjectDataSourceView.ExecuteSelect(DataSourceSelectArguments) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Récupère des données de l'objet qui est identifié par la propriété TypeName en appelant la méthode qui est identifiée par la propriété SelectMethod et en passant toutes valeurs dans la collection SelectParameters.
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 IEnumerableParamètres
- arguments
- DataSourceSelectArguments
DataSourceSelectArguments utilisé pour demander des opérations sur les données, autres que la récupération des données de base.
Retours
Liste IEnumerable de lignes de données.
Exceptions
Les arguments passés à la méthode ExecuteSelect(DataSourceSelectArguments) spécifient que la source de données doit exécuter des tâches supplémentaires lors de la récupération des données pour activer la pagination ou trier les données récupérées, mais le contrôle de source de données ne prend pas en charge la fonction demandée.
- ou -
L'objet retourné par la méthode ExecuteSelect(DataSourceSelectArguments) n'est pas DataSet ou DataTable, et la mise en cache est activée. Seuls les objets DataSet et DataTable peuvent être mis en cache pour le contrôle ObjectDataSourceView.
- ou -
La mise en cache et l'emprunt d'identité client sont activés tous les deux. ObjectDataSource ne prend pas en charge la mise en cache lorsque l'emprunt d'identité du client est activé.
L'objet retourné par la méthode ExecuteSelect(DataSourceSelectArguments) est un DataSet, mais il n'a pas de table dans sa collection Tables.
- ou -
La propriété EnablePaging a la valeur true, mais les propriétés StartRowIndexParameterName et MaximumRowsParameterName ne sont pas définies.
Remarques
La ObjectDataSourceView classe implémente la méthode héritée ExecuteSelect pour récupérer des données à l’aide d’un objet métier. Les développeurs de pages et les auteurs de contrôles liés aux données n’appellent pas directement la ExecuteSelect méthode ; à la place, utilisez la méthode exposée Select publiquement.
La méthode spécifiée peut avoir n’importe quelle signature de méthode, mais doit retourner l’un des types pour le ObjectDataSource contrôle répertoriés dans le tableau suivant pour l’appeler correctement.
| Type de retour | Action |
|---|---|
| IEnumerable | le IEnumerable est retourné par la Select méthode . |
| DataTable | Un DataView est créé à l’aide du DataTable et retourné par la Select méthode . |
| DataSet | Le premier DataTable est DataSet extrait et un DataView est créé et retourné par la Select méthode . |
| Object | L’objet est encapsulé dans un élément IEnumerable unique et retourné par la Select méthode . |
Avant la récupération des données, la OnSelecting méthode est appelée pour déclencher l’événement Selecting . Vous pouvez gérer cet événement pour examiner les valeurs des paramètres et effectuer tout prétraitement avant une opération.
Pour effectuer une opération de sélection, le contrôle utilise la ObjectDataSourceView réflexion pour appeler la méthode identifiée par la SelectMethod propriété et tous les paramètres associés qui se trouvent dans la SelectParameters collection, puis l’exécute. Une fois l’opération terminée, la OnSelected méthode est appelée pour déclencher l’événement Selected . Vous pouvez gérer cet événement pour examiner les valeurs de retour et les codes d’erreur, et pour effectuer tout post-traitement.
Si la Select méthode retourne un DataSet objet et que la mise en cache est activée, le ObjectDataSourceView récupère les données de et les enregistre dans le cache pendant l’opération. Le cache est créé, ignoré ou actualisé en fonction du comportement de mise en cache spécifié par la combinaison des CacheDuration propriétés et CacheExpirationPolicy .
Si la Select méthode retourne un DataSet objet et qu’une FilterExpression propriété a été spécifiée, il est évalué avec toutes les propriétés fournies FilterParameters et le filtre résultant est appliqué à la liste des données pendant l’opération Select .
Pour plus d’informations sur le retour du nombre de lignes sélectionnées, consultez Select.
