ButtonColumn 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.

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

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 dans un DataGrid contrôle pour créer un bouton qui correspond à chaque ligne du DataGrid contrôle. Spécifiez le légende affiché 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 dans une source de données. Cela vous permet d’afficher des sous-titres différents pour chaque bouton. Les valeurs du champ spécifié sont utilisées pour le texte légende. Définissez la DataTextField propriété de manière à lier à ButtonColumn 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 du ButtonColumn déclenche l’événement ItemCommand . Vous pouvez contrôler par programmation l’action effectuée lorsque vous cliquez sur le bouton 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 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 propriété sur CausesValidationtrue.

Constructeurs

ButtonColumn()

Initialise une nouvelle instance de la classe ButtonColumn.

Propriétés

ButtonType	Obtient ou définit le type de bouton à afficher dans l'objet ButtonColumn.
CausesValidation	Obtient ou définit une valeur indiquant si une validation est effectuée suite à un clic sur le bouton dans l'objet ButtonColumn.
CommandName	Obtient ou définit une chaîne qui représente la commande à effectuer lorsqu'un clic a été effectué sur le bouton dans l'objet ButtonColumn.
DataTextField	Obtient ou définit le nom de champ issu 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 indiquant si la colonne est en mode design. (Hérité de DataGridColumn)
FooterStyle	Obtient les propriétés de style pour la section de pied de page de la colonne. (Hérité de DataGridColumn)
FooterText	Obtient ou définit le texte affiché dans la section de 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 pour 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éments de la colonne. (Hérité de DataGridColumn)
Owner	Obtient le contrôle DataGrid dont la colonne est membre. (Hérité de DataGridColumn)
SortExpression	Obtient ou définit le nom du champ ou de l'expression à passer à la méthode OnSortCommand(DataGridSortCommandEventArgs) lorsqu'une colonne est sélectionnée pour être triée. (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 lequel l'objet ButtonColumn provoque la validation lors de la publication sur le serveur.
ViewState	Obtient l'objet StateBag qui permet à une colonne dérivée de la classe DataGridColumn 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 contrôle DataGrid. (Hérité de DataGridColumn)

Méthodes

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 propriété DataTextFormatString.
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()	Rétablit l'objet ButtonColumn à son état initial.
InitializeCell(TableCell, Int32, ListItemType)	Rétablit l'état initial d'une cellule figurant dans l'objet ButtonColumn.
LoadViewState(Object)	Charge l'état de l'objet DataGridColumn. (Hérité de DataGridColumn)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
OnColumnChanged()	Appelle la méthode OnColumnsChanged(). (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 de l'état d'affichage pour le contrôle serveur afin qu'elles puissent être stockées dans l'objet StateBag du contrôle serveur. (Hérité de DataGridColumn)

Implémentations d’interfaces explicites

IStateManager.IsTrackingViewState	Obtient une valeur qui indique si la colonne suit les changements de l'état d'affichage. (Hérité de DataGridColumn)
IStateManager.LoadViewState(Object)	Charge l'état enregistré précédemment. (Hérité de DataGridColumn)
IStateManager.SaveViewState()	Retourne un objet contenant les modifications de l'état. (Hérité de DataGridColumn)
IStateManager.TrackViewState()	Commence à suivre les modifications d'état. (Hérité de DataGridColumn)

S’applique à

Partager via