AccessDataSourceView.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 du stockage de données sous-jacent à l'aide de la chaîne SQL dans la propriété SelectCommand et des paramètres de 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

IEnumerable de lignes de données.

Exceptions

InvalidOperationException

La propriété DataFile est une chaîne vide ("") ou a la valeur null.

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.

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 les 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 un 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 objet à l’aide IDbCommand du SelectCommand texte et de toutes les propriétés associées SelectParameters . Ensuite, l’objet AccessDataSourceView exécute l’objet sur le IDbCommand 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 un post-traitement.

Si la DataSourceMode propriété est définie sur la valeur et que la DataSet mise en cache est activée, le AccessDataSourceView récupère les données et les enregistre 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 CacheDuration propriétés et CacheExpirationPolicy .

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 résultant est appliqué à la liste des données pendant l’opération Select .

S’applique à

Voir aussi