Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez aussi afficher la version anglaise dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte.
Traduction
Anglais
Cette documentation est archivée et n’est pas conservée.

CommandField, classe

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

Le type CommandField expose les membres suivants.

  NomDescription
Méthode publiqueCommandFieldInitialise une nouvelle instance de la classe CommandField.
Début

  NomDescription
Propriété publiqueAccessibleHeaderTextObtient ou définit le texte restitué sous forme de valeur de propriété AbbreviatedText dans certains contrôles. (Hérité de DataControlField.)
Propriété publiqueButtonTypeObtient ou définit le type de bouton à afficher dans le champ de bouton. (Hérité de ButtonFieldBase.)
Propriété publiqueCancelImageUrlObtient ou définit l'URL vers une image à afficher pour le bouton Annuler dans un champ CommandField.
Propriété publiqueCancelTextObtient ou définit la légende du bouton Annuler affiché dans un champ CommandField.
Propriété publiqueCausesValidationObtient ou définit une valeur indiquant si la validation est exécutée lorsque l'utilisateur clique sur un bouton dans un champ CommandField. (Substitue ButtonFieldBase.CausesValidation.)
Propriété protégéeControlObtient une référence au contrôle de données auquel l'objet DataControlField est associé. (Hérité de DataControlField.)
Propriété publiqueControlStyleObtient le style de tout contrôle serveur Web contenu dans l'objet DataControlField. (Hérité de DataControlField.)
Propriété publiqueDeleteImageUrlObtient ou définit l'URL vers une image à afficher pour un bouton Supprimer dans un champ CommandField.
Propriété publiqueDeleteTextObtient ou définit la légende d'un bouton Supprimer dans un champ CommandField.
Propriété protégéeDesignModeObtient 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é publiqueEditImageUrlObtient ou définit l'URL vers une image à afficher pour un bouton Modifier dans un champ CommandField.
Propriété publiqueEditTextObtient ou définit la légende d'un bouton Modifier dans un champ CommandField.
Propriété publiqueFooterStyleObtient ou définit le style du pied de page du champ de contrôle de données. (Hérité de DataControlField.)
Propriété publiqueFooterTextObtient 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é publiqueHeaderImageUrlObtient 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é publiqueHeaderStyleObtient ou définit le style de l'en-tête du champ de contrôle de données. (Hérité de DataControlField.)
Propriété publiqueHeaderTextObtient 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é publiqueInsertImageUrlObtient ou définit l'URL vers une image à afficher pour le bouton Insérer dans un champ CommandField.
Propriété publiqueInsertTextObtient ou définit la légende du bouton Insérer dans un champ CommandField.
Propriété publiqueInsertVisibleObtient 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éeIsTrackingViewStateObtient une valeur indiquant si l'objet DataControlField enregistre les modifications apportées à son état d'affichage. (Hérité de DataControlField.)
Propriété publiqueItemStyleObtient le style de tout contenu de type texte affiché dans un champ de contrôle de données. (Hérité de DataControlField.)
Propriété publiqueNewImageUrlObtient ou définit l'URL vers une image à afficher pour le bouton Nouveau dans un champ CommandField.
Propriété publiqueNewTextObtient ou définit la légende du bouton Nouveau dans un champ CommandField.
Propriété publiqueSelectImageUrlObtient ou définit l'URL vers une image à afficher pour un bouton Sélectionner dans un champ CommandField.
Propriété publiqueSelectTextObtient ou définit la légende d'un bouton Sélectionner dans un champ CommandField.
Propriété publiqueShowCancelButtonObtient ou définit une valeur indiquant si un bouton Annuler est affiché dans un champ CommandField.
Propriété publiqueShowDeleteButtonObtient ou définit une valeur indiquant si un bouton Supprimer est affiché dans un champ CommandField.
Propriété publiqueShowEditButtonObtient ou définit une valeur indiquant si un bouton Modifier est affiché dans un champ CommandField.
Propriété publiqueShowHeaderObtient ou définit une valeur indiquant si l'en-tête s'affiche dans un objet ButtonFieldBase. (Hérité de ButtonFieldBase.)
Propriété publiqueShowInsertButtonObtient ou définit une valeur indiquant si un bouton Nouveau est affiché dans un champ CommandField.
Propriété publiqueShowSelectButtonObtient ou définit une valeur indiquant si un bouton Sélectionner est affiché dans un champ CommandField.
Propriété publiqueSortExpressionObtient 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é publiqueUpdateImageUrlObtient ou définit l'URL vers une image à afficher pour un bouton Mettre à jour dans un champ CommandField.
Propriété publiqueUpdateTextObtient ou définit la légende d'un bouton Mettre à jour dans un champ CommandField.
Propriété publiqueValidationGroupObtient 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éeViewStateObtient 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é publiqueVisibleObtient ou définit une valeur indiquant si un champ de contrôle de données est restitué. (Hérité de DataControlField.)
Début

  NomDescription
Méthode protégéeCloneFieldInfrastructure. Crée une copie de l'objet dérivé de DataControlField en cours. (Hérité de DataControlField.)
Méthode protégéeCopyPropertiesCopie les propriétés de l'objet CommandField actuel vers l'objet DataControlField spécifié. (Substitue ButtonFieldBase.CopyProperties(DataControlField).)
Méthode protégéeCreateFieldCrée un objet CommandField vide. (Substitue DataControlField.CreateField().)
Méthode publiqueEquals(Object)Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
Méthode publiqueExtractValuesFromCellExtrait 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éeFinalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publiqueGetHashCodeSert de fonction de hachage pour un type particulier. (Hérité de Object.)
Méthode publiqueGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publiqueInitializeEffectue l'initialisation d'instance de base pour un champ de contrôle de données. (Hérité de DataControlField.)
Méthode publiqueInitializeCellInitialise l'objet DataControlFieldCell spécifié à l'état de ligne spécifié. (Substitue DataControlField.InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32).)
Méthode protégéeLoadViewStateRestaure l'état d'affichage enregistré précédemment pour la vue de source de données. (Hérité de DataControlField.)
Méthode protégéeMemberwiseCloneCrée une copie superficielle de l'objet Object actif. (Hérité de Object.)
Méthode protégéeOnFieldChangedDéclenche l'événement FieldChanged. (Hérité de DataControlField.)
Méthode protégéeSaveViewStateEnregistre les modifications apportées à l'état d'affichage DataControlField depuis la publication de la page sur le serveur. (Hérité de DataControlField.)
Méthode publiqueToStringRetourne une chaîne qui représente cet objet DataControlField. (Hérité de DataControlField.)
Méthode protégéeTrackViewStateAinsi, 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 publiqueValidateSupportsCallbackDétermine si les contrôles contenus dans un objet CommandField prennent en charge les rappels. (Substitue DataControlField.ValidateSupportsCallback().)
Début

  NomDescription
Implémentation d'interface explicitePropriété privéeIDataSourceViewSchemaAccessor.DataSourceViewSchemaInfrastructure. Obtient ou définit le schéma associé à cet objet DataControlField. (Hérité de DataControlField.)
Implémentation d'interface explicitePropriété privéeIStateManager.IsTrackingViewStateInfrastructure. 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 expliciteMéthode privéeIStateManager.LoadViewStateInfrastructure. 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 expliciteMéthode privéeIStateManager.SaveViewStateInfrastructure. 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 expliciteMéthode privéeIStateManager.TrackViewStateInfrastructure. 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 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.

Property

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.

Property

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.

Property

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é de 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#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>CommandField Example</title>
</head>
<body>
    <form id="form1" 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#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>CommandField Example</title>
</head>
<body>
    <form id="form1" 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>



.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.
Afficher: