Exporter (0) Imprimer
Développer tout

CommandField, classe

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

Représente un champ spécial qui affiche des boutons de commande pour exécuter des opérations de sélection, modification, insertion ou suppression dans un contrôle lié aux données.

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

public class CommandField : ButtonFieldBase
public class CommandField extends ButtonFieldBase
public class CommandField extends ButtonFieldBase

La classe CommandField est un champ spécial utilisé par les contrôles liés aux données (tels que GridView et DetailsView) pour afficher les boutons de commande qui exécutent les opérations de suppression, modification, insertion ou sélection. Les boutons de commande permettant d'exécuter ces opérations peuvent être affichés ou masqués à l'aide des propriétés indiquées dans le tableau suivant.

Propriété

Description

ShowDeleteButton

Affiche ou masque un bouton Supprimer dans un champ CommandField pour chaque enregistrement dans le contrôle lié aux données. Le bouton Supprimer permet à l'utilisateur de supprimer un enregistrement de la source de données.

ShowEditButton

Affiche ou masque un bouton Modifier dans un champ CommandField pour chaque enregistrement dans le contrôle lié aux données. Le bouton Modifier permet à l'utilisateur de modifier un enregistrement de la source de données. Lorsque l'utilisateur clique sur le bouton Modifier pour un enregistrement spécifique, ce bouton Modifier est remplacé par un bouton Mettre à jour et un bouton Annuler. Tous les autres boutons de commande sont également masqués.

ShowInsertButton

Affiche ou masque le bouton Nouveau dans un champ CommandField. Le bouton Nouveau permet à l'utilisateur d'insérer un nouvel enregistrement dans la source de données. Lorsque l'utilisateur clique sur le bouton Nouveau, il est remplacé par un bouton Insérer et un bouton Annuler. Tous les autres boutons de commande sont également masqués.

RemarqueRemarque

Cette propriété s'applique uniquement à des contrôles liés aux données qui prennent en charge des opérations d'insertion, tels que le contrôle DetailsView.

ShowSelectButton

Affiche ou masque un bouton Sélectionner dans un champ CommandField pour chaque enregistrement dans le contrôle lié aux données. Le bouton Sélectionner permet à l'utilisateur de sélectionner un enregistrement dans le contrôle lié aux données.

De plus, le bouton Annuler affiché lorsqu'un enregistrement est en mode édition ou insertion peut être affiché ou masqué en définissant la propriété ShowCancelButton.

RemarqueRemarque

Lorsqu'un contrôle lié aux données est utilisé en association avec un contrôle de source de données (tel qu'un contrôle SqlDataSource), le contrôle lié aux données peut bénéficier des fonctionnalités du contrôle de source de données et fournir des fonctionnalités de suppression, mise à jour et insertion automatiques. Pour que d'autres sources de données exécutent ces opérations pendant les événements appropriés pour le contrôle lié aux données, vous devez fournir les routines.

L'affichage du champ CommandField varie en fonction du contrôle lié aux données dans lequel il est utilisé. Par exemple, le contrôle GridView affiche un champ CommandField comme une colonne, tandis que le contrôle DetailsView l'affiche comme une ligne.

Pour spécifier le type de bouton à afficher, utilisez la propriété ButtonType. Lorsque la propriété ButtonType a la valeur ButtonType.Button ou ButtonType.Link, vous pouvez spécifier le texte à afficher pour les boutons en définissant les propriétés indiquées dans le tableau suivant.

Propriété

Description

CancelText

Légende du bouton Annuler.

DeleteText

Légende du bouton Supprimer.

EditText

Légende du bouton Modifier.

InsertText

Légende du bouton Insérer.

RemarqueRemarque

Cette propriété s'applique uniquement à des contrôles liés aux données qui prennent en charge des opérations d'insertion, comme le contrôle DetailsView.

NewText

Légende du bouton Nouveau.

RemarqueRemarque

Cette propriété s'applique uniquement à des contrôles liés aux données qui prennent en charge des opérations d'insertion, comme le contrôle DetailsView.

SelectText

Légende du bouton Sélectionner.

UpdateText

Légende du bouton Mettre à jour.

Au lieu d'afficher un bouton de commande ou un bouton de lien, vous pouvez afficher un bouton d'image en affectant la valeur ButtonType.Image à la propriété ButtonType et définissant ensuite les propriétés indiquées dans le tableau suivant.

Propriété

Description

CancelImageUrl

Image à afficher pour le bouton Annuler

DeleteImageUrl

Image à afficher pour le bouton Supprimer.

EditImageUrl

Image à afficher pour le bouton Modifier.

InsertText

Image à afficher pour le bouton Insérer.

RemarqueRemarque

Cette propriété s'applique uniquement à des contrôles liés aux données qui prennent en charge des opérations d'insertion, comme le contrôle DetailsView.

NewImageUrl

Image à afficher pour le bouton Nouveau.

RemarqueRemarque

Cette propriété s'applique uniquement à des contrôles liés aux données qui prennent en charge des opérations d'insertion, comme le contrôle DetailsView.

SelectImageUrl

Image à afficher pour le bouton Sélectionner.

UpdateImageUrl

Image à afficher pour le bouton Mettre à jour.

Par défaut, lorsque l'utilisateur clique sur un bouton dans un champ CommandField, la validation est exécutée sur tous les contrôles de validation de la page. Pour éviter que la validation ne se produise lorsque l'utilisateur clique sur un bouton, affectez la valeur false à la propriété CausesValidation.

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

Le champ CommandField 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 la propriété 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 CommandField, 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 CommandField (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

Description

ControlStyle

Paramètres de style pour les contrôles serveur Web enfants de l'objet CommandField.

FooterStyle

Paramètres de style de la section de pied de page de l'objet CommandField.

HeaderStyle

Paramètres de style de la section d'en-tête de l'objet CommandField.

ItemStyle

Paramètres de style des éléments de données dans l'objet CommandField.

L'exemple de code suivant montre comment utiliser une propriété CommandField pour afficher des contrôles afin de modifier un enregistrement dans un contrôle GridView.


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

<html>
  <body>
    <form runat="server">
      
      <h3>CommandField Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        datakeynames="CustomerID"  
        runat="server">
        
        <columns>
          <asp:commandfield showeditbutton="true"
            headertext="Edit Controls"/>
          <asp:boundfield datafield="CustomerID"
            headertext="Customer ID" />
          <asp:boundfield datafield="CompanyName"
            headertext="Company Name"/>
          <asp:boundfield datafield="Address"
            headertext="Address"/>
          <asp:boundfield datafield="City"
            headertext="City"/>
          <asp:boundfield datafield="PostalCode"
            headertext="ZIP Code"/>
          <asp:boundfield datafield="Country"
            headertext="Country"/>
        </columns>
        
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects  -->
      <!-- to the Northwind sample database. Use an ASP.NET     -->
      <!-- expression to retrieve the connection string value   -->
      <!-- from the Web.config file.                            -->
      <asp:sqldatasource id="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        updatecommand="Update Customers Set CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country Where (CustomerID = @CustomerID)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>


L'exemple de code suivant montre comment utiliser les propriétés CancelText, EditText et UpdateText pour personnaliser le texte des contrôles d'édition.


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

<html>
  <body>
    <form runat="server">
      
      <h3>CommandField Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        datakeynames="CustomerID"  
        runat="server">
        
        <columns>
          <asp:commandfield showeditbutton="true"
            edittext="Edit Customer"
            canceltext="Discard"
            updatetext="Revise"
            headertext="Edit Controls"/>
          <asp:boundfield datafield="CustomerID"
            headertext="Customer ID" />
          <asp:boundfield datafield="CompanyName"
            headertext="Company Name"/>
          <asp:boundfield datafield="Address"
            headertext="Address"/>
          <asp:boundfield datafield="City"
            headertext="City"/>
          <asp:boundfield datafield="PostalCode"
            headertext="ZIP Code"/>
          <asp:boundfield datafield="Country"
            headertext="Country"/>
        </columns>
        
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects  -->
      <!-- to the Northwind sample database. Use an ASP.NET     -->
      <!-- expression to retrieve the connection string value   -->
      <!-- from the Web.config file.                            -->
      <asp:sqldatasource id="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        updatecommand="Update Customers Set CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country Where (CustomerID = @CustomerID)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>


  • 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

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft