Esta página foi útil?
Seus comentários sobre este conteúdo são importantes. Queremos saber sua opinião.
Comentários adicionais?
1500 caracteres restantes
Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

Classe ButtonField

Representa um campo que é exibido como um botão em um controle ligado a dados.

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (em System.Web.dll)

[AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public class ButtonField : ButtonFieldBase

The ButtonField classe é usada pelos controles ligados a dados (sistema autônomo GridView e DetailsView) para exibir um botão para cada registro é exibido. The ButtonField objeto é exibido de maneira diferente dependendo o controle limite a dados em que é usado. Por exemplo, a GridView controle exibe um ButtonField objeto sistema autônomo uma coluna, enquanto o DetailsView controle o exibirá sistema autônomo uma linha.

Clicar em um botão em um campo botão gera o evento de comando de dados pai-limite controle.Você pode fornecer uma rotina personalizada para executar quando um botão de comando é clicado, fornecendo um manipulador de eventos para o evento de comando.

ObservaçãoObservação:

O GridView controlar gera o RowCommand evento, enquanto o DetailsView controlar gera o ItemCommand evento.

Para determinar o índice do registro que dispara o evento de comando, use o CommandArgument propriedade do argumento de evento que é passado para o evento de comando para o controle limite a dados. The ButtonField classe preenche automaticamente o CommandArgument propriedade com o valor de índice apropriado.

Para especificar o tipo de botão para exibir, use o ButtonType propriedade. Ao exibir um link ou botão de comando, use o Text propriedade para especificar a legenda para exibir os botões.

ObservaçãoObservação:

Se conjunto o Text propriedade, todos os botões de um ButtonField Compartilhe a mesma legenda.

Como alternativa, você pode BIND o ButtonField objeto a um campo em uma fonte de dados. Isso permite que você exiba diferentes legendas para os botões no ButtonField objeto. Os valores no campo especificado são usados para as legendas de texto dos botões.conjunto o DataTextField propriedade para BIND um ButtonField objeto a um campo em uma fonte de dados.

Ao exibir um botão de imagem, use o ImageUrl propriedade para especificar a imagem a ser exibida para os botões da ButtonField objeto.

ObservaçãoObservação:

Todos os botões de um ButtonField objeto compartilham a mesma imagem.

Você pode ocultar um ButtonField objeto em um controle limite a dados pelo configuração o Visible propriedade para false.

The ButtonField objeto permite que você personalize suas seções de cabeçalho e rodapé. Para exibir uma legenda na seção de cabeçalho ou rodapé, conjunto o HeaderText ou FooterText Propriedades, respectivamente. Em vez de exibir texto na seção de cabeçalho, você pode exibir uma imagem por configuração o HeaderImageUrl propriedade. Para ocultar a seção de cabeçalho em um ButtonField objeto, conjunto o ShowHeader propriedade para false.

ObservaçãoObservação:

Alguns dados-limite controles (tais sistema autônomo o GridView controle) pode mostrar ou ocultar apenas a seção de cabeçalho inteiro do controle. Esses controles ligados a dados não oferecem suporte a ShowHeader propriedade para um campo botão individual. Para mostrar ou ocultar a seção de cabeçalho inteiro de um controle limite a dados (se disponível), use o ShowHeader propriedade do controle.

Você também pode personalizar a aparência do ButtonField objeto (cor de fonte, cor do plano de fundo e assim por diante) por configuração as propriedades de estilo para diferentes partes do campo. A tabela a seguir lista as propriedades de estilo diferente.

Propriedade de estilo

As configurações de estilo para

ControlStyle

Os controles filho do servidor Web do ButtonField.

FooterStyle

A seção de rodapé do ButtonField.

HeaderStyle

A seção de cabeçalho do ButtonField.

ItemStyle

Os itens de dados no ButtonField.

O exemplo de código a seguir demonstra como usar um ButtonField objeto para exibir uma coluna de botões de comando em um GridView controle.


<%@ Page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN""http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  void CustomersGridView_RowCommand(Object sender, GridViewCommandEventArgs e)
  {

    // If multiple ButtonField column fields are used, use the// CommandName property to determine which button was clicked.if(e.CommandName=="Select")
    {

      // Convert the row index stored in the CommandArgument// property to an Integer.int index = Convert.ToInt32(e.CommandArgument);    

      // Get the last name of the selected author from the appropriate// cell in the GridView control.
      GridViewRow selectedRow = CustomersGridView.Rows[index];
      TableCell contactName = selectedRow.Cells[1];
      string contact = contactName.Text;  

      // Display the selected author.
      Message.Text = "You selected " + contact + ".";

    }

  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ButtonField Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>ButtonField Example</h3>

      <asp:label id="Message"
        forecolor="Red"
        runat="server"
        AssociatedControlID="CustomersGridView"/>

      <!-- Populate the Columns collection declaratively. -->
      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        onrowcommand="CustomersGridView_RowCommand"
        runat="server">

        <columns>

          <asp:buttonfield buttontype="Button" 
            commandname="Select"
            headertext="Select Customer" 
            text="Select"/>
          <asp:boundfield datafield="CompanyName" 
            headertext="Company Name"/>
          <asp:boundfield datafield="ContactName" 
            headertext="Contact Name"/>

        </columns>

      </asp:gridview>

        <!-- This example uses Microsoft SQL Server and connects -->
        <!-- to the Northwind sample database.                   -->
        <asp:sqldatasource id="CustomersSqlDataSource"  
          selectcommand="Select [CustomerID], [CompanyName], [ContactName], [ContactTitle] From [Customers]"
          connectionstring="<%$ ConnectionStrings:NorthWindConnection%>"
          runat="server">
        </asp:sqldatasource>

    </form>
  </body>
</html>



Quaisquer membros static (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

o.NET Framework e.NET Compact Framework não oferecem suporte a todas as versões de cada plataforma. Para obter uma lista de versões suportadas, consulte Requisitos de sistema do .NET framework.

.NET Framework

Compatível com: 3.5, 3.0, 2.0

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2015 Microsoft