GridView.RowDataBound Evento
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Ocorre quando uma linha de dados está ligada a dados num GridView controlo.
public:
event System::Web::UI::WebControls::GridViewRowEventHandler ^ RowDataBound;public event System.Web.UI.WebControls.GridViewRowEventHandler RowDataBound;member this.RowDataBound : System.Web.UI.WebControls.GridViewRowEventHandler Public Custom Event RowDataBound As GridViewRowEventHandler Tipo de Evento
Exemplos
Um projeto Visual Studio site com código-fonte está disponível para acompanhar este tema: Download.
O exemplo seguinte demonstra como usar o RowDataBound evento para modificar o valor de um campo na fonte de dados antes de este ser exibido num GridView controlo.
<%@ 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, cada linha do controlo deve estar associada a um registo na fonte de dados. 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 vinculados à linha, sempre que este evento ocorre.
Um GridViewRowEventArgs objeto é passado para o método de gestão de eventos, que permite aceder às propriedades da linha a ser atribuída. Para aceder a uma célula específica na linha, use a Cells propriedade do GridViewRow objeto contida na Row propriedade do GridViewRowEventArgs objeto. Pode determinar que tipo de linha (linha de cabeçalho, linha de dados, etc.) está a ser limitada usando a RowType propriedade.
Para mais informações sobre como gerir eventos, consulte Gestão e Levantamento de Eventos.