Cette documentation est archivée et n’est pas conservée.

SqlDataSource.Select, méthode

Remarque : cette méthode est nouvelle dans le .NET Framework version 2.0.

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.

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)

public IEnumerable Select (
	DataSourceSelectArguments arguments
)
public IEnumerable Select (
	DataSourceSelectArguments arguments
)
public function Select (
	arguments : DataSourceSelectArguments
) : IEnumerable

Paramètres

arguments

DataSourceSelectArguments utilisé pour demander des opérations sur les données, autres que la récupération des données de base.

Valeur de retour

Liste IEnumerable de lignes de données.

Type d'exceptionCondition

InvalidOperationException

SqlDataSource ne peut pas établir de connexion avec la source de données sous-jacente.

La méthode Select retourne un objet DataView si la propriété DataSourceMode a la valeur DataSet, ou un objet IDataReader si la propriété DataSourceMode a la valeur DataReader. Fermez l'objet IDataReader lorsque vous avez fini de lire les données.

Avant que l'opération Select soit effectuée, la méthode OnSelecting 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 l'opération Select.

Lorsque l'opération Select est terminée, la méthode OnSelected 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, ainsi que pour effectuer tout post-traitement.

Si la propriété DataSourceMode a la valeur DataSet et si la mise en cache est activée, l'objet SqlDataSource récupère des données du cache et les enregistre sur le cache pendant l'opération Select. Le cache est créé, ignoré ou actualisé selon le comportement de mise en cache spécifié par la combinaison des propriétés CacheDuration et CacheExpirationPolicy.

Remarque de sécuritéRemarque de sécurité

Lorsque vous utilisez l'emprunt d'identité du client dans le cadre de l'authentification Microsoft 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, elles sont récupérées 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 prévoyez que plusieurs utilisateurs accèdent aux données et souhaitez que chaque récupération de 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 DataSourceMode a la valeur DataSet et si une propriété FilterExpression a été spécifiée, il est évalué avec toutes les propriétés FilterParameters fournies et le filtre obtenu est appliqué à la liste de données pendant l'opération Select.

La méthode Selectdélègue à la méthode Select de l'objet SqlDataSourceView associé au contrôle SqlDataSource. Pour exécuter une opération de récupération, SqlDataSourceView génère un objet DbCommand à l'aide du texte SelectCommand et de tout SelectParameters associé, puis exécute DbCommand sur la base de données sous-jacente.

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0
Afficher: