Expandir Minimizar
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
Este tópico ainda não foi avaliado como - Avalie este tópico

Propriedade GridView.AutoGenerateSelectButton

Obtém ou define um valor indicando se uma coluna de campo de CommandField com um botão select para cada linha de dados é automaticamente adicionada a um controle de GridView .

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (em System.Web.dll)
public virtual bool AutoGenerateSelectButton { get; set; }
<asp:GridView AutoGenerateSelectButton="True|False" />

Valor de propriedade

Tipo: System.Boolean
true para adicionar automaticamente uma coluna de campo de CommandField com um botão select para cada linha de dados; caso contrário, false. O padrão é false.

Quando a propriedade de AutoGenerateSelectButton é definida como, trueuma coluna (representado por um objeto de CommandField ) com um botão select para cada linha de dados é automaticamente adicionada ao controle de GridView . Clique no botão para selecionar uma linha seleciona essa linha no controle, que define a propriedade de SelectedIndex o índice da linha. Para recuperar GridViewRow objeto que representa a linha selecionada, use a propriedade de SelectedRow . Você também pode obter o valor de chave primária para o registro selecionado usando a propriedade de SelectedValue . A propriedade de SelectedValue contém os valores dos campos especificados na propriedade de DataKeyNames .

ObservaçãoObservação

Você pode programaticamente selecione uma linha definindo a propriedade de SelectedIndex . Para cancelar a seleção de uma linha, defina a propriedade de SelectedIndex a -1.

Você pode controlar a aparência da linha selecionada usando a propriedade de SelectedRowStyle . As configurações comuns incluem geralmente uma cor do plano de fundo personalizado, cor de primeiro plano, e propriedades da fonte.

O controle de GridView fornece vários eventos que você pode usar para executar uma ação personalizada quando uma linha está selecionada. a seguinte tabela lista os eventos disponíveis.

Evento

Descrição

SelectedIndexChanged

Ocorre quando o botão select de uma linha é clicado, mas após o controle manipula de GridView a operação de seleção. Este evento é freqüentemente usado para executar uma tarefa após uma linha está selecionada no controle.

SelectedIndexChanging

Ocorre quando o botão select de uma linha é clicado, mas antes do controle manipula de GridView a operação de seleção. Este evento é freqüentemente usado para cancelar a operação selecionar.

O exemplo seguinte demonstra como usar a propriedade de AutoGenerateSelectButton para ativar o recurso automática de seleção de controle de GridView .



<%@ 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_SelectedIndexChanged(Object sender, EventArgs e)
  {

    // Get the currently selected row using the SelectedRow property.
    GridViewRow row = CustomersGridView.SelectedRow;

    // Display the company name from the selected row.
    // In this example, the third column (index 2) contains
    // the company name.
    MessageLabel.Text = "You selected " + row.Cells[2].Text + ".";

  }

  void CustomersGridView_SelectedIndexChanging(Object sender, GridViewSelectEventArgs e)
  {

    // Get the currently selected row. Because the SelectedIndexChanging event
    // occurs before the select operation in the GridView control, the
    // SelectedRow property cannot be used. Instead, use the Rows collection
    // and the NewSelectedIndex property of the e argument passed to this 
    // event handler.
    GridViewRow row = CustomersGridView.Rows[e.NewSelectedIndex];

    // You can cancel the select operation by using the Cancel
    // property. For this example, if the user selects a customer with 
    // the ID "ANATR", the select operation is canceled and an error message
    // is displayed.
    if (row.Cells[1].Text == "ANATR")
    {

      e.Cancel = true;
      MessageLabel.Text = "You cannot select " + row.Cells[2].Text + ".";

    }

  }

</script>

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

     <h3>GridView Select Example</h3>

     <asp:gridview id="CustomersGridView" 
       datasourceid="CustomersSource" 
       autogeneratecolumns="False"
       autogenerateselectbutton="True"
       allowpaging="True" 
       selectedindex="1"
       onselectedindexchanged="CustomersGridView_SelectedIndexChanged"
       onselectedindexchanging="CustomersGridView_SelectedIndexChanging"   
       runat="server" DataKeyNames="CustomerID">

         <Columns>
             <asp:BoundField DataField="CustomerID" 
                 HeaderText="CustomerID" 
                 InsertVisible="False" ReadOnly="True" 
                 SortExpression="CustomerID" />
             <asp:BoundField DataField="FirstName" 
                 HeaderText="FirstName" 
                 SortExpression="FirstName" />
             <asp:BoundField DataField="MiddleName" 
                 HeaderText="MiddleName" 
                 SortExpression="MiddleName" />
             <asp:BoundField DataField="LastName" 
                 HeaderText="LastName" 
                 SortExpression="LastName" />
             <asp:BoundField DataField="Phone" 
                 HeaderText="Phone" 
                 SortExpression="Phone" />
         </Columns>

       <selectedrowstyle backcolor="LightCyan"
         forecolor="DarkBlue"
         font-bold="true"/>  

     </asp:gridview>

      <br/>

      <asp:label id="MessageLabel"
        forecolor="Red"
        runat="server"/>

      <!-- This example uses Microsoft SQL Server and connects  -->
      <!-- to the Northwind sample database. Use an ASP.NET     -->
      <!-- expression to retrieve the connection string value   -->
      <!-- from the Web.config file.                            -->
      <asp:sqldatasource id="CustomersSource"
        selectcommand="SELECT CustomerID, FirstName, MiddleName, LastName, Phone FROM SalesLT.Customer"
        connectionstring="<%$ ConnectionStrings:AdventureWorksLTConnectionString %>" 
        runat="server"/>

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



.NET Framework

Com suporte em: 4.5, 4, 3.5, 3.0, 2.0

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte .Requisitos de sistema do NET Framework.
Isso foi útil para você?
(1500 caracteres restantes)

Contribuições da comunidade

ADICIONAR
A Microsoft está realizando uma pesquisa online para saber sua opinião sobre o site do MSDN. Se você optar por participar, a pesquisa online lhe será apresentada quando você sair do site do MSDN.

Deseja participar?
© 2013 Microsoft. Todos os direitos reservados.