ButtonColumn Classe

Referência

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

Compartilhar via