Exporter (0) Imprimer
Développer tout
Ce sujet n'a pas encore été évalué - Évaluez ce sujet

ButtonField, classe

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

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

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

public class ButtonField : ButtonFieldBase
public class ButtonField extends ButtonFieldBase
public class ButtonField extends ButtonFieldBase

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 une 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.

RemarqueRemarque

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.

RemarqueRemarque

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.

RemarqueRemarque

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.

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.

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é du 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.


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

<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>
  <body>
    <form runat="server">
        
      <h3>ButtonField Example</h3>
      
      <asp:label id="Message"
        forecolor="Red"
        runat="server"/>
                    
      <!-- 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>


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
Cela vous a-t-il été utile ?
(1500 caractères restants)
Merci pour vos suggestions.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft. Tous droits réservés.