ButtonColumn Classe

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.

Type de colonne pour le contrôle qui contient un bouton défini par l’utilisateur DataGrid .

public ref class ButtonColumn : System::Web::UI::WebControls::DataGridColumn

public class ButtonColumn : System.Web.UI.WebControls.DataGridColumn

type ButtonColumn = class
    inherit DataGridColumn

Public Class ButtonColumn
Inherits DataGridColumn

Héritage: Object

DataGridColumn
ButtonColumn

Exemples

L’exemple de code suivant montre comment utiliser ButtonColumn la classe dans un DataGrid contrôle pour créer des boutons Ajouter .

private void Page_Init(Object sender, EventArgs e)
{

   // Create dynamic column to add to Columns collection.
   ButtonColumn AddColumn = new ButtonColumn();
   AddColumn.HeaderText="Add Item";
   AddColumn.Text="Add";
   AddColumn.CommandName="Add";
   AddColumn.ButtonType = ButtonColumnType.PushButton;

   // Add column to Columns collection.
   ItemsGrid.Columns.AddAt(2, AddColumn);
}

Private Sub Page_Init(sender As Object, e As EventArgs)
    
    ' Create dynamic column to add to Columns collection.
    Dim AddColumn As New ButtonColumn()
    AddColumn.HeaderText = "Add Item"
    AddColumn.Text = "Add"
    AddColumn.CommandName = "Add"
    AddColumn.ButtonType = ButtonColumnType.PushButton

    
    ' Add column to Columns collection.
    ItemsGrid.Columns.AddAt(2, AddColumn)
End Sub

Remarques

Utilisez la ButtonColumn classe d’un DataGrid contrôle pour créer un bouton qui correspond à chaque ligne du DataGrid contrôle. Spécifiez la légende affichée dans les boutons en définissant la Text propriété. Si vous définissez la Text propriété, tous les boutons de l’objet ButtonColumn partagent la même légende. Vous pouvez également lier les ButtonColumn boutons à un champ d’une source de données. Cela vous permet d’afficher différentes légendes pour chaque bouton. Les valeurs du champ spécifié sont utilisées pour la légende de texte. Définissez la DataTextField propriété pour lier le ButtonColumn champ à un champ dans une source de données.

Vous pouvez mettre en forme les légendes affichées dans les boutons en définissant la DataTextField propriété avec une chaîne de mise en forme.

Cliquer sur les boutons dans l’événement ButtonColumn déclenche l’événement ItemCommand . Vous pouvez contrôler par programmation l’action effectuée lorsque le bouton est cliqué en fournissant un gestionnaire d’événements pour l’événement ItemCommand .

Par défaut, la validation de page n’est pas effectuée lorsqu’un bouton dans le ButtonColumn bouton est cliqué. La validation de page détermine si les contrôles d’entrée associés à un contrôle de validation sur la page réussissent tous les règles de validation spécifiées par le contrôle de validation. Pour effectuer la validation de page lorsqu’un bouton est cliqué, définissez la CausesValidation propriété truesur .

Constructeurs

Nom	Description
ButtonColumn()	Initialise une nouvelle instance de la classe ButtonColumn.

Propriétés

Nom	Description
ButtonType	Obtient ou définit le type de bouton à afficher dans l’objet ButtonColumn .
CausesValidation	Obtient ou définit une valeur indiquant si la validation est effectuée lorsqu’un bouton dans l’objet ButtonColumn est cliqué.
CommandName	Obtient ou définit une chaîne qui représente la commande à effectuer lorsqu’un bouton dans l’objet ButtonColumn est cliqué.
DataTextField	Obtient ou définit le nom du champ d’une source de données à lier à l’objet ButtonColumn .
DataTextFormatString	Obtient ou définit la chaîne qui spécifie le format d’affichage de la légende dans chaque bouton.
DesignMode	Obtient une valeur qui indique si la colonne est en mode création. (Hérité de DataGridColumn)
FooterStyle	Obtient les propriétés de style de la section pied de page de la colonne. (Hérité de DataGridColumn)
FooterText	Obtient ou définit le texte affiché dans la section pied de page de la colonne. (Hérité de DataGridColumn)
HeaderImageUrl	Obtient ou définit l’emplacement d’une image à afficher dans la section d’en-tête de la colonne. (Hérité de DataGridColumn)
HeaderStyle	Obtient les propriétés de style de la section d’en-tête de la colonne. (Hérité de DataGridColumn)
HeaderText	Obtient ou définit le texte affiché dans la section d’en-tête de la colonne. (Hérité de DataGridColumn)
IsTrackingViewState	Obtient une valeur qui détermine si l’objet DataGridColumn est marqué pour enregistrer son état. (Hérité de DataGridColumn)
ItemStyle	Obtient les propriétés de style pour les cellules d’élément de la colonne. (Hérité de DataGridColumn)
Owner	Obtient le DataGrid contrôle dont la colonne est membre. (Hérité de DataGridColumn)
SortExpression	Obtient ou définit le nom du champ ou de l’expression à passer à la OnSortCommand(DataGridSortCommandEventArgs) méthode lorsqu’une colonne est sélectionnée pour le tri. (Hérité de DataGridColumn)
Text	Obtient ou définit la légende affichée dans les boutons de l’objet ButtonColumn .
ValidationGroup	Obtient ou définit le groupe de contrôles de validation pour lesquels l’objet provoque la ButtonColumn validation lorsqu’il revient au serveur.
ViewState	Obtient l’objet StateBag qui permet à une colonne dérivée de la DataGridColumn classe de stocker ses propriétés. (Hérité de DataGridColumn)
Visible	Obtient ou définit une valeur qui indique si la colonne est visible dans le DataGrid contrôle. (Hérité de DataGridColumn)

Méthodes

Nom	Description
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
FormatDataTextValue(Object)	Convertit la valeur spécifiée au format indiqué par la DataTextFormatString propriété.
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
Initialize()	Réinitialise l’objet ButtonColumn à son état initial.
InitializeCell(TableCell, Int32, ListItemType)	Réinitialise une cellule dans l’objet ButtonColumn à son état initial.
LoadViewState(Object)	Charge l’état de l’objet DataGridColumn . (Hérité de DataGridColumn)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
OnColumnChanged()	Appelle la OnColumnsChanged() méthode. (Hérité de DataGridColumn)
SaveViewState()	Enregistre l’état actuel de l’objet DataGridColumn . (Hérité de DataGridColumn)
ToString()	Retourne la représentation sous forme de chaîne de la colonne. (Hérité de DataGridColumn)
TrackViewState()	Provoque le suivi des modifications d’état d’affichage apportées au contrôle serveur afin qu’ils puissent être stockés dans l’objet du StateBag contrôle serveur. (Hérité de DataGridColumn)

Implémentations d’interfaces explicites

Nom	Description
IStateManager.IsTrackingViewState	Obtient une valeur qui indique si la colonne suit les modifications de l’état d’affichage. (Hérité de DataGridColumn)
IStateManager.LoadViewState(Object)	Charge l’état précédemment enregistré. (Hérité de DataGridColumn)
IStateManager.SaveViewState()	Retourne un objet contenant les modifications d’état. (Hérité de DataGridColumn)
IStateManager.TrackViewState()	Démarre le suivi des modifications d’état. (Hérité de DataGridColumn)

S’applique à

Voir aussi

Commentaires

Cette page a-t-elle été utile ?