GridViewRowEventArgs Classe

Definição

Espaço de Nomes:
System.Web.UI.WebControls
Assemblagem:
System.Web.dll

Fornece dados para os eventos RowCreated e RowDataBound.

public ref class GridViewRowEventArgs : EventArgs
public class GridViewRowEventArgs : EventArgs
type GridViewRowEventArgs = class
    inherit EventArgs
Public Class GridViewRowEventArgs
Inherits EventArgs
Herança
Object
EventArgs
GridViewRowEventArgs

Exemplos

O exemplo seguinte demonstra como usar o GridViewRowEventArgs objeto passado para o método de gestão de eventos para aceder às propriedades da linha que está a ser associada aos dados.


<%@ 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_RowDataBound(Object sender, GridViewRowEventArgs e)
  {
        
    if(e.Row.RowType == DataControlRowType.DataRow)
    {
      // Display the company name in italics.
      e.Row.Cells[1].Text = "<i>" + e.Row.Cells[1].Text + "</i>";
        
    }
    
  }

</script>

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

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="true"
        allowpaging="true"
        onrowdatabound="CustomersGridView_RowDataBound" 
        runat="server">
      </asp:gridview>
            
      <!-- 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="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>
            
            
    </form>
  </body>
</html>


<%@ Page language="VB" %>

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

  Sub CustomersGridView_RowDataBound(ByVal sender As Object, ByVal e As GridViewRowEventArgs)

    If e.Row.RowType = DataControlRowType.DataRow Then
    
      ' Display the company name in italics.
      e.Row.Cells(1).Text = "<i>" & e.Row.Cells(1).Text & "</i>"
        
    End If
    
  End Sub

</script>

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

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="true"
        allowpaging="true"
        onrowdatabound="CustomersGridView_RowDataBound" 
        runat="server">
      </asp:gridview>
            
      <!-- 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="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>
            
            
    </form>
  </body>
</html>

Observações

Antes de o GridView controlo poder ser renderizado, deve ser criado um GridViewRow objeto para cada linha do controlo. O RowCreated evento é elevado cada vez que uma linha no GridView controlo é criada. Isto permite-lhe fornecer um método de gestão de eventos que executa uma rotina personalizada, como adicionar conteúdo personalizado a uma linha, sempre que este evento ocorre.

De forma semelhante, cada linha do controlo deve estar associada a um registo na fonte de dados antes de o GridView controlo poder ser renderizado. O RowDataBound evento é ativado quando uma linha de dados (representada por um GridViewRow objeto) está ligada a dados no GridView controlo. Isto permite-lhe fornecer um método de gestão de eventos que executa uma rotina personalizada, como modificar os valores dos dados atribuídos à linha, sempre que este evento ocorre.

Um objeto é passado para o método de gestão de eventos, que permite aceder às propriedades da linha que gerou GridViewRowEventArgs o evento. Para aceder a uma célula específica na linha, use a Cells propriedade do GridViewRow objeto contido nessa Row propriedade. Também pode determinar que tipo de linha (linha de cabeçalho, linha de dados, etc.) está a ser criada usando a RowType propriedade do GridViewRow objeto.

Para mais informações sobre como gerir eventos, consulte Gestão e Levantamento de Eventos.

Para obter uma lista de valores das propriedades iniciais de uma instância de GridViewRowEventArgs, consulte o construtor GridViewRowEventArgs.

Construtores

Name Description
GridViewRowEventArgs(GridViewRow)

Inicializa uma nova instância da GridViewRowEventArgs classe.

Propriedades

Name Description
Row

Obtém a linha que está a ser criada ou ligada aos dados.

Métodos

Name Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Ver também