ButtonColumn Classe

Definição

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

Herança

Object

DataGridColumn

ButtonColumn

Exemplos

O exemplo de código seguinte demonstra como usar ButtonColumn uma classe num DataGrid controlo para criar botões de Adicionar .

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

Observações

Use a ButtonColumn classe num DataGrid controlo para criar um botão que corresponda a cada linha do DataGrid controlo. Especifique a legenda que aparece nos botões definindo a Text propriedade. Se definires a Text propriedade, todos os botões do ButtonColumn objeto partilham a mesma legenda. Alternativamente, pode atribuir os ButtonColumn botões a um campo numa fonte de dados. Isto permite mostrar legendas diferentes para cada botão. Os valores no campo especificado são usados para a legenda do texto. Defina a DataTextField propriedade para ligar o ButtonColumn a um campo numa fonte de dados.

Pode formatar as legendas que aparecem nos botões definindo a DataTextField propriedade com uma cadeia de formatação.

Clicar nos botões ButtonColumn no evento aumenta ItemCommand o evento. Pode controlar programaticamente a ação realizada quando o botão é carregado, fornecendo um gestor de eventos para o ItemCommand evento.

Por defeito, a validação da página não é realizada quando um botão é ButtonColumn clicado. A validação de página determina se os controlos de entrada associados a um controlo de validação na página passam todos pelas regras de validação especificadas pelo controlo de validação. Para realizar a validação da página quando um botão é clicado, defina a CausesValidation propriedade para true.

Ver também

• DataGrid
• DataGridColumn
• BoundColumn
• EditCommandColumn
• HyperLinkColumn
• TemplateColumn
• Button
• LinkButton