Accueil Library Formation Téléchargements Support technique Communauté
Connexion | United States - English | |
Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte.
Traduction
Source
Ce sujet n'a pas encore été évalué - Évaluez ce sujet

ButtonField, classe

.NET Framework 4

Représente un champ qui est affiché sous forme de bouton dans un contrôle lié aux données.

System.Object
  System.Web.UI.WebControls.DataControlField
    System.Web.UI.WebControls.ButtonFieldBase
      System.Web.UI.WebControls.ButtonField

Espace de noms :  System.Web.UI.WebControls
Assembly :  System.Web (dans System.Web.dll)
C#
C++
F#
VB
Copier 
public class ButtonField : ButtonFieldBase

Le type ButtonField expose les membres suivants.

  Nom Description
Méthode publique ButtonField Initialise une nouvelle instance de la classe ButtonField.
Début
  Nom Description
Propriété publique AccessibleHeaderText Obtient ou définit le texte restitué sous forme de valeur de propriété AbbreviatedText dans certains contrôles. (Hérité de DataControlField.)
Propriété publique ButtonType Obtient ou définit le type de bouton à afficher dans le champ de bouton. (Hérité de ButtonFieldBase.)
Propriété publique CausesValidation Obtient ou définit une valeur indiquant si une validation est effectuée lorsqu'un clic est effectué sur le bouton dans un objet ButtonFieldBase. (Hérité de ButtonFieldBase.)
Propriété publique CommandName Obtient ou définit une chaîne qui représente l'action à effectuer lorsqu'un clic a été effectué sur le bouton dans un objet ButtonField.
Propriété protégée Control Obtient une référence au contrôle de données auquel l'objet DataControlField est associé. (Hérité de DataControlField.)
Propriété publique ControlStyle Obtient le style de tout contrôle serveur Web contenu dans l'objet DataControlField. (Hérité de DataControlField.)
Propriété publique DataTextField Obtient ou définit le nom du champ de données auquel la valeur est liée à la propriété Text du contrôle Button restitué par l'objet ButtonField.
Propriété publique DataTextFormatString Obtient ou définit la chaîne qui spécifie le format d'affichage de la valeur du champ.
Propriété protégée DesignMode Obtient une valeur indiquant si un champ de contrôle de données est actuellement affiché dans un environnement au moment du design. (Hérité de DataControlField.)
Propriété publique FooterStyle Obtient ou définit le style du pied de page du champ de contrôle de données. (Hérité de DataControlField.)
Propriété publique FooterText Obtient ou définit le texte affiché dans l'élément de pied de page d'un champ de contrôle de données. (Hérité de DataControlField.)
Propriété publique HeaderImageUrl Obtient ou définit l'URL d'une image affichée dans l'élément d'en-tête d'un champ de contrôle de données. (Hérité de DataControlField.)
Propriété publique HeaderStyle Obtient ou définit le style de l'en-tête du champ de contrôle de données. (Hérité de DataControlField.)
Propriété publique HeaderText Obtient ou définit le texte affiché dans l'élément d'en-tête d'un champ de contrôle de données. (Hérité de DataControlField.)
Propriété publique ImageUrl Obtient ou définit l'image à afficher pour chaque bouton dans l'objet ButtonField.
Propriété publique InsertVisible Obtient une valeur indiquant si l'objet DataControlField est visible lorsque son contrôle lié aux données parent est en mode insertion. (Hérité de DataControlField.)
Propriété protégée IsTrackingViewState Obtient une valeur indiquant si l'objet DataControlField enregistre les modifications apportées à son état d'affichage. (Hérité de DataControlField.)
Propriété publique ItemStyle Obtient le style de tout contenu de type texte affiché dans un champ de contrôle de données. (Hérité de DataControlField.)
Propriété publique ShowHeader Obtient ou définit une valeur indiquant si l'en-tête s'affiche dans un objet ButtonFieldBase. (Hérité de ButtonFieldBase.)
Propriété publique SortExpression Obtient ou définit une expression de tri utilisée par un contrôle de source de données pour trier des données. (Hérité de DataControlField.)
Propriété publique Text Obtient ou définit la légende statique affichée pour chaque bouton dans l'objet ButtonField.
Propriété publique ValidationGroup Obtient ou définit le nom du groupe de contrôles de validation à valider lorsqu'un clic est effectué sur un bouton d'un objet ButtonFieldBase. (Hérité de ButtonFieldBase.)
Propriété protégée ViewState Obtient un dictionnaire d'informations d'état qui vous permet d'enregistrer et de restaurer l'état d'affichage d'un objet DataControlField entre plusieurs demandes de la même page. (Hérité de DataControlField.)
Propriété publique Visible Obtient ou définit une valeur indiquant si un champ de contrôle de données est restitué. (Hérité de DataControlField.)
Début
  Nom Description
Méthode protégée CloneField Infrastructure. Crée une copie de l'objet dérivé de DataControlField en cours. (Hérité de DataControlField.)
Méthode protégée CopyProperties Copie les propriétés de l'objet ButtonField actuel vers l'objet DataControlField spécifié. (Substitue ButtonFieldBase.CopyProperties(DataControlField).)
Méthode protégée CreateField Crée et retourne une nouvelle instance de la classe ButtonField. (Substitue DataControlField.CreateField().)
Méthode publique Equals(Object) Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
Méthode publique ExtractValuesFromCell Extrait la valeur du champ de contrôle de données à partir de la cellule active du tableau et ajoute la valeur à la collection IDictionary spécifiée. (Hérité de DataControlField.)
Méthode protégée Finalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de netto***ge avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode protégée FormatDataTextValue Met en forme la valeur de champ spécifiée pour une cellule dans l'objet ButtonField.
Méthode publique GetHashCode Sert de fonction de hachage pour un type particulier. (Hérité de Object.)
Méthode publique GetType Obtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publique Initialize Initialise l'objet ButtonField actuel. (Substitue DataControlField.Initialize(Boolean, Control).)
Méthode publique InitializeCell Initialise l'objet DataControlFieldCell spécifié à l'état de ligne spécifié. (Substitue DataControlField.InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32).)
Méthode protégée LoadViewState Restaure l'état d'affichage enregistré précédemment pour la vue de source de données. (Hérité de DataControlField.)
Méthode protégée MemberwiseClone Crée une copie superficielle de l'objet Object actif. (Hérité de Object.)
Méthode protégée OnFieldChanged Déclenche l'événement FieldChanged. (Hérité de DataControlField.)
Méthode protégée SaveViewState Enregistre les modifications apportées à l'état d'affichage DataControlField depuis la publication de la page sur le serveur. (Hérité de DataControlField.)
Méthode publique ToString Retourne une chaîne qui représente cet objet DataControlField. (Hérité de DataControlField.)
Méthode protégée TrackViewState Ainsi, l'objet DataControlField effectue le suivi des modifications de son état d'affichage afin qu'elles puissent être stockées dans la propriété ViewState du contrôle et être persistantes entre les demandes de la même page. (Hérité de DataControlField.)
Méthode publique ValidateSupportsCallback Détermine si les contrôles contenus dans un objet ButtonField prennent en charge les rappels. (Substitue DataControlField.ValidateSupportsCallback().)
Début
  Nom Description
Implémentation d'interface explicite Propriété privée IDataSourceViewSchemaAccessor.DataSourceViewSchema Infrastructure. Obtient ou définit le schéma associé à cet objet DataControlField. (Hérité de DataControlField.)
Implémentation d'interface explicite Propriété privée IStateManager.IsTrackingViewState Infrastructure. Obtient une valeur indiquant si l'objet DataControlField enregistre les modifications apportées à son état d'affichage. (Hérité de DataControlField.)
Implémentation d'interface explicite Méthode privée IStateManager.LoadViewState Infrastructure. Restaure l'état d'affichage enregistré précédemment pour le champ de contrôle de données. (Hérité de DataControlField.)
Implémentation d'interface explicite Méthode privée IStateManager.SaveViewState Infrastructure. Enregistre les modifications apportées à l'état d'affichage DataControlField depuis la publication de la page sur le serveur. (Hérité de DataControlField.)
Implémentation d'interface explicite Méthode privée IStateManager.TrackViewState Infrastructure. Ainsi, l'objet DataControlField effectue le suivi des modifications de son état d'affichage afin qu'elles puissent être stockées dans la propriété ViewState du contrôle et être persistantes entre les demandes de la même page. (Hérité de DataControlField.)
Début

La classe ButtonField est utilisée par les contrôles liés aux données (tel que GridView et DetailsView) pour afficher un bouton pour chaque enregistrement affiché. L'affichage de l'objet ButtonField varie en fonction du contrôle lié aux données dans lequel il est utilisé. Par exemple, le contrôle GridView affiche un objet ButtonField sous forme de colonne, tandis que le contrôle DetailsView l'affiche sous 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 de commande en fournissant un gestionnaire d'événements pour l'événement de commande.

Remarque Remarque

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

Pour déterminer l'index de l'enregistrement qui déclenche l'événement de commande, utilisez la propriété CommandArgument de l'argument d'événement qui est passé à l'événement de commande pour le contrôle lié aux données. La classe ButtonField remplit automatiquement la propriété CommandArgument avec la valeur d'index appropriée.

Pour spécifier le type de bouton à afficher, utilisez la propriété ButtonType. Lorsque vous affichez un lien ou un bouton de commande, utilisez la propriété Text pour spécifier la légende à afficher dans les boutons.

Remarque Remarque

Si vous définissez la propriété Text, tous les boutons d'un ButtonField partagent la même légende.

Vous pouvez également lier l'objet ButtonField à un champ dans une source de données. Cela vous permet d'afficher différentes légendes pour les boutons dans l'objet ButtonField. Les valeurs contenues dans le champ spécifié sont utilisées pour les légendes de texte des boutons. Définissez la propriété DataTextField pour lier un objet ButtonField à un champ dans une source de données.

Lorsque vous affichez un bouton d'image, utilisez la propriété ImageUrl pour spécifier l'image à afficher pour les boutons dans l'objet ButtonField.

Remarque Remarque

Tous les boutons d'un objet ButtonField partagent la même image.

Vous pouvez masquer un objet ButtonField dans un contrôle lié aux données en affectant la valeur false à la propriété Visible.

L'objet ButtonField vous permet de personnaliser ses sections d'en-tête et de pied de page. Pour afficher une légende dans la section d'en-tête ou de pied de page, définissez les propriétés HeaderText ou FooterText, respectivement. Au lieu d'afficher du texte dans la section d'en-tête, vous pouvez afficher une image en définissant la propriété HeaderImageUrl. Pour masquer la section d'en-tête dans un objet ButtonField, affectez la valeur false à la propriété ShowHeader.

Remarque Remarque

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.

Vous pouvez également personnaliser l'apparence de l'objet ButtonField (couleur de police, couleur d'arrière-plan, etc.) en définissant les propriétés de style des différentes parties du champ. Le tableau suivant énumère les différentes propriétés de style.

Propriété de style

Paramètres de style de

ControlStyle

Contrôles serveur Web enfants du ButtonField.

FooterStyle

Section de pied de page du ButtonField.

HeaderStyle

Section d'en-tête du ButtonField.

ItemStyle

Éléments de données du ButtonField.

L'exemple de code suivant illustre l'utilisation de l'objet ButtonField pour afficher une colonne de boutons de commande dans un contrôle GridView.

C#
VB
Copier 


<%@ Page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  void CustomersGridView_RowCommand(Object sender, GridViewCommandEventArgs e)
  {

    // If multiple ButtonField column fields are used, use the
    // CommandName property to determine which button was clicked.
    if(e.CommandName=="Select")
    {

      // Convert the row index stored in the CommandArgument
      // property to an Integer.
      int index = Convert.ToInt32(e.CommandArgument);    

      // Get the last name of the selected author from the appropriate
      // cell in the GridView control.
      GridViewRow selectedRow = CustomersGridView.Rows[index];
      TableCell contactName = selectedRow.Cells[1];
      string contact = contactName.Text;  

      // Display the selected author.
      Message.Text = "You selected " + contact + ".";

    }

  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ButtonField Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>ButtonField Example</h3>

      <asp:label id="Message"
        forecolor="Red"
        runat="server"
        AssociatedControlID="CustomersGridView"/>

      <!-- Populate the Columns collection declaratively. -->
      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        onrowcommand="CustomersGridView_RowCommand"
        runat="server">

        <columns>

          <asp:buttonfield buttontype="Button" 
            commandname="Select"
            headertext="Select Customer" 
            text="Select"/>
          <asp:boundfield datafield="CompanyName" 
            headertext="Company Name"/>
          <asp:boundfield datafield="ContactName" 
            headertext="Contact Name"/>

        </columns>

      </asp:gridview>

        <!-- This example uses Microsoft SQL Server and connects -->
        <!-- to the Northwind sample database.                   -->
        <asp:sqldatasource id="CustomersSqlDataSource"  
          selectcommand="Select [CustomerID], [CompanyName], [ContactName], [ContactTitle] From [Customers]"
          connectionstring="<%$ ConnectionStrings:NorthWindConnection%>"
          runat="server">
        </asp:sqldatasource>

    </form>
  </body>
</html>

.NET Framework

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

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
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.
Cela vous a-t-il été utile ?
(1500 caractères restants)
Contenu de la communauté Ajouter
Annotations FAQ