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

SqlDataSourceSelectingEventArgs, classe

Mise à jour : novembre 2007

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)

[AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public class SqlDataSourceSelectingEventArgs : SqlDataSourceCommandEventArgs
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal) */
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal) */
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

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

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

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

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0
Afficher: