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 les données de l’objet identifié par la TypeName propriété en appelant la méthode identifiée par la SelectMethod propriété et en transmettant toutes les valeurs de la SelectParameters collection.
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
Utilisé DataSourceSelectArguments pour demander des opérations sur les données au-delà de la récupération de données de base.
Retours
Liste IEnumerable des lignes de données.
Exceptions
Le arguments passage à la ExecuteSelect(DataSourceSelectArguments) méthode spécifie que la source de données doit effectuer un travail supplémentaire lors de la récupération des données pour activer la pagination ou le tri via les données récupérées, mais le contrôle de source de données ne prend pas en charge la fonctionnalité demandée.
- ou -
L’objet retourné par la ExecuteSelect(DataSourceSelectArguments) méthode n’est pas un DataSet ou DataTable, et la mise en cache est activée. Seuls DataSet et DataTable les objets peuvent être mis en cache pour le ObjectDataSourceView contrôle.
- ou -
La mise en cache et l’emprunt d’identité du client sont activées. La ObjectDataSource prise en charge de la mise en cache n’est pas prise en charge lorsque l’emprunt d’identité du client est activé.
L’objet retourné par la ExecuteSelect(DataSourceSelectArguments) méthode est un DataSet, mais n’a pas de tables dans sa Tables collection.
- ou -
La EnablePaging propriété est définie sur true, mais les StartRowIndexParameterName propriétés ne MaximumRowsParameterName 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 ; utilisez plutôt 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 du ObjectDataSource contrôle répertoriés dans le tableau suivant pour l’appeler correctement.
| Type de retour | Action |
|---|---|
| IEnumerable | L’objet IEnumerable est retourné par la Select méthode. |
| DataTable | A DataView est créé à l’aide de la DataTable méthode et retournée par la Select méthode. |
| DataSet | Le premier DataTable du fichier DataSet est 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 l’exécution de 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 ObjectDataSourceView contrôle utilise la réflexion pour appeler la méthode identifiée par la SelectMethod propriété et 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 une mise en cache est activée, les ObjectDataSourceView données sont récupérées et enregistre les données 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 propriétés et CacheExpirationPolicy des CacheDuration propriétés.
Si la Select méthode retourne un DataSet objet et qu’une FilterExpression propriété a été spécifiée, elle est évaluée avec toutes les propriétés fournies FilterParameters et le filtre obtenu 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.
