CommandField Classe

Référence

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

public ref class CommandField : System::Web::UI::WebControls::ButtonFieldBase

public class CommandField : System.Web.UI.WebControls.ButtonFieldBase

type CommandField = class
    inherit ButtonFieldBase

Public Class CommandField
Inherits ButtonFieldBase

Héritage: Object

DataControlField

ButtonFieldBase
CommandField

Exemples

L’exemple de code suivant montre comment utiliser un CommandField champ pour afficher des contrôles afin de modifier un enregistrement dans un GridView contrôle.


<%@ 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>


<%@ Page language="VB" %>

<!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 CancelTextpropriétés , EditTextet UpdateText pour personnaliser le texte des contrôles de modification.


<%@ 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>


<%@ Page language="VB" %>

<!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>

Remarques

La CommandField classe 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 effectuent des opérations de suppression, de modification, d’insertion ou de sélection. Les boutons de commande permettant d’effectuer 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 CommandField champ pour chaque enregistrement du 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 CommandField champ pour chaque enregistrement du contrôle lié aux données. Le bouton Modifier permet à l’utilisateur de modifier un enregistrement à partir 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 CommandField champ. 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. Note: Cette propriété s’applique uniquement aux contrôles liés aux données qui prennent en charge les opérations d’insertion, telles que le DetailsView contrôle.
ShowSelectButton	Affiche ou masque un bouton Sélectionner dans un CommandField champ pour chaque enregistrement du 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.

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

Notes

Lorsqu’un contrôle lié aux données est utilisé en combinaison avec un contrôle de source de données (tel qu’un SqlDataSource contrôle), le contrôle lié aux données peut tirer parti des fonctionnalités du contrôle de source de données et fournir des fonctionnalités de suppression, de mise à jour et d’insertion automatiques. Pour d’autres sources de données, vous devez fournir les routines permettant d’effectuer ces opérations pendant les événements appropriés pour le contrôle lié aux données.

Le CommandField champ est affiché différemment en fonction du contrôle lié aux données dans lequel il est utilisé. Par exemple, le GridView contrôle affiche un CommandField champ sous forme de colonne, tandis que le contrôle l’affiche DetailsView sous forme de ligne.

Pour spécifier le type de bouton à afficher, utilisez la ButtonType propriété . Lorsque la ButtonType propriété 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. Note: Cette propriété s’applique uniquement aux contrôles liés aux données qui prennent en charge les opérations d’insertion, telles que le DetailsView contrôle .
NewText	Légende du bouton Nouveau. Note: Cette propriété s’applique uniquement aux contrôles liés aux données qui prennent en charge les opérations d’insertion, telles que le DetailsView contrôle .
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 image en définissant la ButtonType propriété ButtonType.Image sur, puis en définissant les propriétés affiché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. Note: Cette propriété s’applique uniquement aux contrôles liés aux données qui prennent en charge les opérations d’insertion, telles que le DetailsView contrôle .
NewImageUrl	Image à afficher pour le bouton Nouveau. Note: Cette propriété s’applique uniquement aux contrôles liés aux données qui prennent en charge les opérations d’insertion, telles que le DetailsView contrôle .
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, la CommandField validation est effectuée sur tous les contrôles de validation de la page. Pour empêcher la validation de se produire lorsque l’utilisateur clique sur un bouton, définissez la propriété sur CausesValidationfalse.

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

Le CommandField champ vous permet de personnaliser ses sections d’en-tête et de pied de page. Pour afficher une légende dans l’en-tête ou la section de pied de page, définissez la HeaderText FooterText propriété ou , respectivement. Au lieu d’afficher du texte dans la section d’en-tête, vous pouvez afficher une image en définissant la HeaderImageUrl propriété . Pour masquer la section d’en-tête dans un CommandField objet, définissez la propriété sur ShowHeaderfalse.

Notes

Certains contrôles liés aux données (tels que le GridView contrôle) peuvent afficher ou masquer uniquement la section d’en-tête entière du contrôle. Ces contrôles liés aux données ne prennent pas en charge la ShowHeader propriété d’un champ de bouton individuel. Pour afficher ou masquer la section d’en-tête entière d’un contrôle lié aux données (si disponible), utilisez la propriété du ShowHeader 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 pour les différentes parties du champ. Le tableau suivant répertorie les différentes propriétés de style.

Propriété Style	Description
ControlStyle	Paramètres de style pour les contrôles serveur Web enfants de l’objet CommandField .
FooterStyle	Paramètres de style pour la section de pied de page de l’objet CommandField .
HeaderStyle	Paramètres de style pour la section d’en-tête de l’objet CommandField .
ItemStyle	Paramètres de style pour les éléments de données dans l’objet CommandField .

Constructeurs

CommandField()

Initialise une nouvelle instance de la classe CommandField.

Propriétés

AccessibleHeaderText	Obtient ou définit le texte restitué sous forme de valeur de propriété `AbbreviatedText` dans certains contrôles. (Hérité de DataControlField)
ButtonType	Obtient ou définit le type de bouton à afficher dans le champ de bouton. (Hérité de ButtonFieldBase)
CancelImageUrl	Obtient ou définit l'URL vers une image à afficher pour le bouton Annuler dans un champ CommandField.
CancelText	Obtient ou définit la légende du bouton Annuler affiché dans un champ CommandField.
CausesValidation	Obtient ou définit une valeur indiquant si la validation est exécutée lorsque l'utilisateur clique sur un bouton dans un champ CommandField.
Control	Obtient une référence au contrôle de données auquel l'objet DataControlField est associé. (Hérité de DataControlField)
ControlStyle	Obtient le style de tout contrôle serveur Web contenu dans l'objet DataControlField. (Hérité de DataControlField)
DeleteImageUrl	Obtient ou définit l'URL vers une image à afficher pour un bouton Supprimer dans un champ CommandField.
DeleteText	Obtient ou définit la légende d'un bouton Supprimer dans un champ CommandField.
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)
EditImageUrl	Obtient ou définit l'URL vers une image à afficher pour un bouton Modifier dans un champ CommandField.
EditText	Obtient ou définit la légende d'un bouton Modifier dans un champ CommandField.
FooterStyle	Obtient ou définit le style du pied de page du champ de contrôle de données. (Hérité de DataControlField)
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)
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)
HeaderStyle	Obtient ou définit le style de l'en-tête du champ de contrôle de données. (Hérité de DataControlField)
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)
InsertImageUrl	Obtient ou définit l'URL vers une image à afficher pour le bouton Insérer dans un champ CommandField.
InsertText	Obtient ou définit la légende du bouton Insérer dans un champ CommandField.
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)
IsTrackingViewState	Obtient une valeur indiquant si l'objet DataControlField enregistre les modifications apportées à son état d'affichage. (Hérité de DataControlField)
ItemStyle	Obtient le style de tout contenu de type texte affiché dans un champ de contrôle de données. (Hérité de DataControlField)
NewImageUrl	Obtient ou définit l'URL vers une image à afficher pour le bouton Nouveau dans un champ CommandField.
NewText	Obtient ou définit la légende du bouton Nouveau dans un champ CommandField.
SelectImageUrl	Obtient ou définit l'URL vers une image à afficher pour un bouton Sélectionner dans un champ CommandField.
SelectText	Obtient ou définit la légende d'un bouton Sélectionner dans un champ CommandField.
ShowCancelButton	Obtient ou définit une valeur indiquant si un bouton Annuler est affiché dans un champ CommandField.
ShowDeleteButton	Obtient ou définit une valeur indiquant si un bouton Supprimer est affiché dans un champ CommandField.
ShowEditButton	Obtient ou définit une valeur indiquant si un bouton Modifier est affiché dans un champ CommandField.
ShowHeader	Obtient ou définit une valeur indiquant si l'en-tête s'affiche dans un objet ButtonFieldBase. (Hérité de ButtonFieldBase)
ShowInsertButton	Obtient ou définit une valeur indiquant si un bouton Nouveau est affiché dans un champ CommandField.
ShowSelectButton	Obtient ou définit une valeur indiquant si un bouton Sélectionner est affiché dans un champ CommandField.
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)
UpdateImageUrl	Obtient ou définit l'URL vers une image à afficher pour un bouton Mettre à jour dans un champ CommandField.
UpdateText	Obtient ou définit la légende d'un bouton Mettre à jour dans un champ CommandField.
ValidateRequestMode	Obtient ou définit une valeur qui spécifie si le contrôle valide l'entrée du client. (Hérité de DataControlField)
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)
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)
Visible	Obtient ou définit une valeur indiquant si un champ de contrôle de données est restitué. (Hérité de DataControlField)

Méthodes

CloneField()	Crée une copie de l'objet dérivé de DataControlField en cours. (Hérité de DataControlField)
CopyProperties(DataControlField)	Copie les propriétés de l'objet CommandField actuel vers l'objet DataControlField spécifié.
CreateField()	Crée un objet CommandField vide.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	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)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
Initialize(Boolean, Control)	Effectue l'initialisation d'instance de base pour un champ de contrôle de données. (Hérité de DataControlField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Initialise l'objet DataControlFieldCell spécifié à l'état de ligne spécifié.
LoadViewState(Object)	Restaure l'état d'affichage enregistré précédemment pour la vue de source de données. (Hérité de DataControlField)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
OnFieldChanged()	Déclenche l’événement `FieldChanged`. (Hérité de DataControlField)
SaveViewState()	Enregistre les modifications apportées à l'état d'affichage DataControlField depuis la publication de la page sur le serveur. (Hérité de DataControlField)
ToString()	Retourne une chaîne qui représente cet objet DataControlField. (Hérité de DataControlField)
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)
ValidateSupportsCallback()	Détermine si les contrôles contenus dans un objet CommandField prennent en charge les rappels.

Implémentations d’interfaces explicites

IDataSourceViewSchemaAccessor.DataSourceViewSchema	Obtient ou définit le schéma associé à cet objet DataControlField. (Hérité de DataControlField)
IStateManager.IsTrackingViewState	Obtient une valeur indiquant si l'objet DataControlField enregistre les modifications apportées à son état d'affichage. (Hérité de DataControlField)
IStateManager.LoadViewState(Object)	Restaure l'état d'affichage enregistré précédemment pour le champ de contrôle de données. (Hérité de DataControlField)
IStateManager.SaveViewState()	Enregistre les modifications apportées à l'état d'affichage DataControlField depuis la publication de la page sur le serveur. (Hérité de DataControlField)
IStateManager.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)

S’applique à