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

ButtonFieldBase, classe

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

Sert de classe de base abstraite pour les champs de bouton, comme la classe ButtonField ou CommandField. La classe ButtonFieldBase fournit les méthodes et les propriétés communes à tous les champs de bouton.

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

public abstract class ButtonFieldBase : DataControlField
public abstract class ButtonFieldBase extends DataControlField
public abstract class ButtonFieldBase extends DataControlField

La classe ButtonFieldBase est la classe de base abstraite pour les champs de bouton et contient les méthodes et les propriétés communes à tous les champs de bouton. Comme cette classe est abstraite, vous ne pouvez pas en créer d'instance directement. À la place, vous devez créer une instance d'une classe non abstraite qui hérite de la classe ButtonFieldBase, telle que la classe ButtonField ou CommandField.

Un objet qui est dérivé de ButtonFieldBase est utilisé par les contrôles liés aux données (tels que les contrôles GridView et DetailsView) pour afficher un ou plusieurs boutons pour chaque enregistrement affiché. L'affichage du champ d'un bouton varie en fonction du contrôle lié aux données dans lequel il est utilisé. Par exemple, le contrôle GridView affiche un champ de bouton sous la forme de colonne, tandis que le contrôle DetailsView l'affiche sous la forme de ligne.

Si vous cliquez sur un bouton dans un champ de bouton, cela déclenche l'événement de commande du contrôle lié aux données parent. Vous pouvez fournir une routine personnalisée à exécuter lorsqu'un clic est effectué sur un bouton en fournissant un gestionnaire d'événements pour l'événement de commande.

RemarqueRemarque

Le contrôle GridView déclenche l'événement RowCommand, tandis que le contrôle DetailsView déclenche l'événement ItemCommand.

Pour spécifier le type de bouton à afficher, utilisez la propriété ButtonType. Pour afficher ou masquer l'en-tête d'un objet ButtonFieldBase, définissez la propriété ShowHeader.

RemarqueRemarque

Certains contrôles liés aux données (tels que le contrôle GridView) peuvent uniquement afficher ou masquer l'intégralité de la section d'en-tête du contrôle. Ces contrôles liés aux données ne prennent pas en charge la propriété ShowHeader pour un champ de bouton. Pour afficher ou masquer l'intégralité de la section d'en-tête d'un contrôle lié aux données (le cas échéant), utilisez la propriété ShowHeader du contrôle.

Remarques à l'attention des héritiers Lorsque vous héritez de la classe ButtonFieldBase, vous devez substituer le membre suivant : CopyProperties.

  • 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

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: