ButtonColumn Classe

  • Referência

Definição

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Um tipo de coluna para o controle DataGrid que contém um botão definido pelo usuário.

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 o legenda exibido nos botões definindo a Text propriedade . Se você definir a Text propriedade, todos os botões no ButtonColumn objeto compartilharão o mesmo legenda. Como alternativa, você pode associar os ButtonColumn botões a um campo em uma fonte de dados. Isso permite exibir legendas diferentes para cada botão. Os valores no campo especificado são usados para o texto legenda. Defina a DataTextField propriedade para associar o ButtonColumn a um campo em 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 no 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 é 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 for clicado, defina a CausesValidation propriedade como true.

Construtores

ButtonColumn()

Inicializa uma nova instância da classe ButtonColumn.

Propriedades

ButtonType

Obtém ou define o tipo de botão a ser exibido no objeto de ButtonColumn.
CausesValidation

Obtém ou define um valor que indica se a validação é realizada quando um botão no objeto de ButtonColumn é clicado.
CommandName

Obtém ou define uma cadeia de caracteres que representa o comando a ser executado quando um botão no objeto ButtonColumn for clicado.
DataTextField

Obtém ou define o nome do campo de uma fonte de dados para associar ao objeto de ButtonColumn.
DataTextFormatString

Obtém ou define a cadeia de caracteres que especifica o formato de exibição da legenda em cada botão.
DesignMode

Obtém um valor que indica se a coluna está no modo de design.

(Herdado de DataGridColumn)
FooterStyle

Obtém as propriedades de estilo da seção de rodapé da coluna.

(Herdado de DataGridColumn)
FooterText

Obtém ou define o texto exibido na seção de rodapé da coluna.

(Herdado de DataGridColumn)
HeaderImageUrl

Obtém ou define o local de uma imagem a ser exibida na seção de cabeçalho da coluna.

(Herdado de DataGridColumn)
HeaderStyle

Obtém as propriedades de estilo para a seção de cabeçalho da coluna.

(Herdado de DataGridColumn)
HeaderText

Obtém ou define o texto exibido na seção de cabeçalho da coluna.

(Herdado de DataGridColumn)
IsTrackingViewState

Obtém um valor que determina se o objeto DataGridColumn está marcado para salvar seu estado.

(Herdado de DataGridColumn)
ItemStyle

Obtém as propriedades de estilo para as células do item da coluna.

(Herdado de DataGridColumn)
Owner

Obtém o controle DataGrid do qual a coluna é membro.

(Herdado de DataGridColumn)
SortExpression

Obtém ou define o nome do campo ou expressão a ser passado para o método OnSortCommand(DataGridSortCommandEventArgs) quando uma coluna for selecionada para classificação.

(Herdado de DataGridColumn)
Text

Obtém ou define a legenda que é exibida nos botões do objeto ButtonColumn.
ValidationGroup

Obtém ou define o grupo de controles de validação para qual o objeto de ButtonColumn causa a validação quando ele executa um postback para o servidor.
ViewState

Obtém o objeto StateBag que permite que uma coluna derivada da classe DataGridColumn armazene suas propriedades.

(Herdado de DataGridColumn)
Visible

Obtém ou define um valor que indica se a coluna está visível no controle DataGrid.

(Herdado de DataGridColumn)

Métodos

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
FormatDataTextValue(Object)

Converte o valor especificado para o formato que é indicado pela propriedade DataTextFormatString.
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
Initialize()

Redefine o objeto de ButtonColumn para seu estado inicial.
InitializeCell(TableCell, Int32, ListItemType)

Redefine uma célula no objeto de ButtonColumn para seu estado inicial.
LoadViewState(Object)

Carrega o estado do objeto DataGridColumn.

(Herdado de DataGridColumn)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
OnColumnChanged()

Chama o método OnColumnsChanged().

(Herdado de DataGridColumn)
SaveViewState()

Salva o estado atual do objeto DataGridColumn.

(Herdado de DataGridColumn)
ToString()

Retorna a representação de cadeia de caracteres da coluna.

(Herdado de DataGridColumn)
TrackViewState()

Causa o acompanhamento das alterações de estado de exibição para o controle de servidor, para que elas possam ser armazenadas no objeto StateBag do controle de servidor.

(Herdado de DataGridColumn)

Implantações explícitas de interface

IStateManager.IsTrackingViewState

Obtém um valor que indica se a coluna está controlando suas alterações de estado de exibição.

(Herdado de DataGridColumn)
IStateManager.LoadViewState(Object)

Carrega o estado salvo anteriormente.

(Herdado de DataGridColumn)
IStateManager.SaveViewState()

Retorna um objeto que contém as alterações de estado.

(Herdado de DataGridColumn)
IStateManager.TrackViewState()

Inicia o controle de alterações de estado.

(Herdado de DataGridColumn)

Aplica-se a

Confira também