Exporter (0) Imprimer
Développer tout

ButtonColumn, classe

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

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)

public class ButtonColumn : DataGridColumn
public class ButtonColumn extends DataGridColumn
public class ButtonColumn extends 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);

}
   

private void Page_Init(Object sender, EventArgs e)
{
    // Create dynamic column to add to Columns collection.
    ButtonColumn addColumn = new ButtonColumn();
    addColumn.set_HeaderText("Add Item");
    addColumn.set_Text("Add");
    addColumn.set_CommandName("Add");
    addColumn.set_ButtonType(ButtonColumnType.PushButton);
 

    // Add column to Columns collection.
    itemsGrid.get_Columns().AddAt(2, addColumn);
} //Page_Init

private function Page_Init(sender : Object, e : EventArgs) 
{

   // Create dynamic column to add to Columns collection.
   var AddColumn : ButtonColumn = 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);

}
   

System.Object
   System.Web.UI.WebControls.DataGridColumn
    System.Web.UI.WebControls.ButtonColumn

Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft