Partager via


CommandField Classe

Définition

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

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 HeaderTextFooterText 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 à

Voir aussi