ObjectDataSourceView.ExecuteSelect(DataSourceSelectArguments) Méthode

  • Référence

Définition

Espace de noms:
System.Web.UI.WebControls
Assembly:
System.Web.dll

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.IEnumerable
Protected Friend Overrides Function ExecuteSelect (arguments As DataSourceSelectArguments) As IEnumerable

Paramè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

IEnumerable

Liste IEnumerable de lignes de données.

Exceptions

NotSupportedException

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é.

InvalidOperationException

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.

S’applique à

Voir aussi