Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. |
Traduction
Source
|
ButtonColumn, classe
Type de colonne du contrôle DataGrid qui contient un bouton défini par l'utilisateur.
Assembly : System.Web (dans System.Web.dll)
Le type ButtonColumn expose les membres suivants.
| 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 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 System.Web.UI.WebControls.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 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 System.Web.UI.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.) |
| Nom | Description | |
|---|---|---|
|
Equals(Object) | Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.) |
|
Finalize | Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de netto***ge avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.) |
|
|
FormatDataTextValue | Convertit la valeur spécifiée au format indiqué par la propriété DataTextFormatString. |
|
|
GetHashCode | Sert de fonction de hachage pour un type particulier. (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. (Substitue DataGridColumn.Initialize().) |
|
|
InitializeCell | Rétablit l'état initial d'une cellule figurant dans l'objet ButtonColumn. (Substitue DataGridColumn.InitializeCell(TableCell, Int32, ListItemType).) |
|
|
LoadViewState | Charge l'état de l'objet DataGridColumn. (Hérité de DataGridColumn.) |
|
|
MemberwiseClone | Crée une copie superficielle de l'objet Object actif. (Hérité de Object.) |
|
|
OnColumnChanged | Appelle la méthode DataGridDesigner.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 System.Web.UI.StateBag du contrôle serveur. (Hérité de DataGridColumn.) |
| Nom | Description | |
|---|---|---|
|
IStateManager.IsTrackingViewState | Infrastructure. Obtient une valeur qui indique si la colonne suit les changements de l'état d'affichage. (Hérité de DataGridColumn.) |
|
IStateManager.LoadViewState | Infrastructure. Charge l'état enregistré précédemment. (Hérité de DataGridColumn.) |
|
|
IStateManager.SaveViewState | Infrastructure. Retourne un objet contenant les modifications de l'état. (Hérité de DataGridColumn.) |
|
|
IStateManager.TrackViewState | Infrastructure. Commence à suivre les modifications d'état. (Hérité de DataGridColumn.) |
Utilisez la classe ButtonColumn dans un contrôle DataGrid pour créer un bouton qui correspond avec chaque ligne du contrôle DataGrid. Spécifiez la légende qui est affichée dans les boutons en définissant la propriété Text. Si vous définissez la propriété Text, tous les boutons de l'objet ButtonColumn partagent la même légende. Vous pouvez également lier les boutons ButtonColumn à un champ dans une source de données. Cela vous permet d'afficher différentes légendes pour chaque bouton. Les valeurs contenues dans le champ spécifié sont utilisées pour la légende de texte. Définissez la propriété DataTextField pour 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 propriété DataTextField avec une chaîne de mise en forme.
Un clic sur les boutons de ButtonColumn déclenche l'événement ItemCommand. Vous pouvez contrôler par programme l'action effectuée lorsqu'un clic a été effectué 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 exécutée après un clic sur un bouton de ButtonColumn. Une validation de page détermine si les contrôles d'entrée associés à un contrôle de validation sur la page respectent les règles de validation spécifiées par le contrôle de validation. Pour exécuter une validation de page lorsque vous cliquez sur un bouton, affectez la valeur true à la propriété CausesValidation.
L'exemple de code suivant illustre l'utilisation de la classe ButtonColumn dans un contrôle DataGrid pour créer des boutons Ajoutez.
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); }
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.
