AccessDataSourceView.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 du stockage de données sous-jacent à l’aide de la chaîne SQL dans la SelectCommand propriété et de tous les paramètres 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
Lignes IEnumerable de données.
Exceptions
La DataFile propriété est null ou une chaîne vide (« »).
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.
Remarques
L’objet AccessDataSourceView remplace la ExecuteSelect méthode pour s’assurer que la DataFile propriété de son contrôle associé AccessDataSource est définie avant de récupérer des données.
Avant l’exécution de la ExecuteSelect méthode, la OnSelecting méthode est appelée pour déclencher l’événement Selecting . Vous pouvez gérer l’événement Selecting pour examiner les valeurs des paramètres et effectuer tout prétraitement avant une opération de récupération de données.
Pour effectuer la récupération des données, l’objet AccessDataSourceView génère un IDbCommand objet à l’aide du SelectCommand texte et de toutes les propriétés associées SelectParameters . Ensuite, l’objet AccessDataSourceView exécute l’objet IDbCommand sur le stockage de données sous-jacent. 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 l’événement Selected pour examiner les valeurs de retour et les codes d’erreur et effectuer tout post-traitement.
Si la DataSourceMode propriété est définie sur la valeur et la DataSet mise en cache est activée, les AccessDataSourceView données sont extraites et enregistre les données dans le cache pendant l’opération de récupération des données. 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 DataSourceMode propriété est définie sur la DataSet valeur et qu’une FilterExpression propriété a été spécifiée, la DataSourceMode propriété 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 .
