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

SqlDataSourceSelectingEventArgs, classe

Remarque : cette classe est nouvelle dans le .NET Framework version 2.0.

Fournit des données pour l'événement Selecting du contrôle SqlDataSource.

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

public class SqlDataSourceSelectingEventArgs : SqlDataSourceCommandEventArgs
public class SqlDataSourceSelectingEventArgs extends SqlDataSourceCommandEventArgs
public class SqlDataSourceSelectingEventArgs extends SqlDataSourceCommandEventArgs

En ajoutant un délégué de gestionnaire d'événements pour gérer l'événement Selecting, vous pouvez exécuter tout prétraitement supplémentaire requis ou annuler totalement la requête de base de données. La classe SqlDataSourceSelectingEventArgs étant dérivée de la classe SqlDataSourceCommandEventArgs, vous pouvez annuler une requête de base de données SqlDataSource en attente en attribuant la valeur true à la propriété Cancel. Vous pouvez examiner et manipuler CommandText, la collection Parameters et d'autres propriétés de requête de base de données avant d'exécuter la requête en accédant à l'objet DbCommand exposé par la propriété Command. Vous pouvez également examiner l'objet DataSourceSelectArguments qui est passé à la méthode Select en accédant à la propriété Arguments.

La classe SqlDataSourceSelectingEventArgs est utilisée dans la méthode OnSelecting pour fournir l'accès à une requête de base de données SqlDataSource avant qu'elle soit exécutée.

Le contrôle SqlDataSource expose beaucoup d'événements que vous pouvez gérer pour travailler avec les objets de données sous-jacents pendant le déroulement d'une opération de données. Le tableau suivant répertorie les événements et les classes EventArgs et délégués de gestionnaires d'événements associés.

Événement

EventArgs

EventHandler

Selecting.

Se produit avant la récupération des données.

SqlDataSourceSelectingEventArgs

SqlDataSourceSelectingEventHandler

Inserting, Updating et Deleting.

Se produisent avant une opération d'insertion, de mise à jour ou de suppression.

SqlDataSourceCommandEventArgs

SqlDataSourceCommandEventHandler

Selected, Inserted, Updated et Deleted.

Se produit une fois terminées les opérations de récupération, d'insertion, de mise à jour ou de suppression des données.

SqlDataSourceStatusEventArgs

SqlDataSourceStatusEventHandler

  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : LinkDemand ; valeur d'autorisation : Minimal
  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : InheritanceDemand ; valeur d'autorisation : Minimal

System.Object
   System.EventArgs
     System.ComponentModel.CancelEventArgs
       System.Web.UI.WebControls.SqlDataSourceCommandEventArgs
        System.Web.UI.WebControls.SqlDataSourceSelectingEventArgs

Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

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: