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 a seguir demonstra como usar ButtonColumn a classe em um DataGrid controle para criar botões 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

Comentários

Use a ButtonColumn classe em um DataGrid controle para criar um botão que corresponda a cada linha no DataGrid controle. Especifique a legenda exibida nos botões definindo a Text propriedade. Se você definir a Text propriedade, todos os botões no ButtonColumn objeto compartilharão a mesma legenda. Como alternativa, você pode associar os ButtonColumn botões a um campo em uma fonte de dados. Isso permite que você exiba legendas diferentes para cada botão. Os valores no campo especificado são usados para a legenda de texto. Defina a DataTextField propriedade para associar o ButtonColumn campo a uma fonte de dados.

Você pode formatar as legendas exibidas nos botões definindo a DataTextField propriedade com uma cadeia de caracteres de formatação.

Clicar nos botões nos ButtonColumn aciona o ItemCommand evento. Você pode controlar programaticamente a ação executada quando o botão é clicado fornecendo um manipulador de eventos para o ItemCommand evento.

Por padrão, a validação de página não é executada quando um botão no ButtonColumn clique é clicado. A validação de página determina se os controles de entrada associados a um controle de validação na página passam todas as regras de validação especificadas pelo controle de validação. Para executar a validação de página quando um botão é clicado, defina a CausesValidation propriedade como true.

Confira também

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