SqlDataSourceView.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 la base de données sous-jacente à l'aide de la chaîne SQL 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

Objet 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 -

La mise en cache est activée, mais la propriété DataSourceMode de la source de données n'a pas la valeur DataSet.

- ou -

La propriété SortParameterName est définie, mais CommandType n'a pas la valeur StoredProcedure.

InvalidOperationException

La source de données ne peut pas créer de connexion de base de données.

- ou -

La mise en cache est activée, mais les types de caches internes et de commandes ne correspondent pas.

Remarques

La SqlDataSourceView classe implémente la méthode héritée ExecuteSelect pour récupérer des données d’une base de données. 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.

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 un prétraitement avant la récupération des données.

Pour effectuer l’opération, l’objet SqlDataSourceView génère un DbCommand objet à l’aide du SelectCommand texte et de tout associé SelectParameters, et l’exécute sur la base de données sous-jacente. 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, les codes d’erreur et effectuer un post-traitement.

La ExecuteSelect méthode retourne un DataView objet si est DataSourceMode défini sur DataSet, ou un IDataReader objet si est DataSourceMode défini sur DataReader. Fermez l’objet IDataReader lorsque vous avez terminé la lecture des données.

Si est DataSourceMode défini sur DataSet et que la mise en cache est activée, le SqlDataSourceView récupère les données et les enregistre dans le cache pendant l’opération de 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 .

Important

Lorsque vous utilisez l’emprunt d’identité client sous Authentification Windows, les données sont mises en cache lorsque le premier utilisateur accède aux données. Si un autre utilisateur demande les mêmes données, les données sont récupérées à partir du cache. Les données ne sont pas récupérées en effectuant un autre appel à la base de données pour vérifier l’accès de l’utilisateur aux données. Si vous vous attendez à ce que plusieurs utilisateurs accèdent aux données et que vous souhaitez que chaque récupération des données soit vérifiée par les configurations de sécurité de la base de données, n’utilisez pas la mise en cache.

Si est DataSourceMode défini sur DataSet et qu’un FilterExpression a été spécifié, il est évalué avec tous les éléments fournis FilterParameters et que le filtre résultant est appliqué à la liste des données pendant l’opération de récupération de données.

S’applique à

Voir aussi