GridView.RowDataBound Gebeurtenis
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Treedt op wanneer een gegevensrij is gebonden aan gegevens in een GridView besturingselement.
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 Gebeurtenistype
Voorbeelden
Er is een Visual Studio-websiteproject met broncode beschikbaar voor dit onderwerp: Download.
In het volgende voorbeeld ziet u hoe u de RowDataBound gebeurtenis gebruikt om de waarde van een veld in de gegevensbron te wijzigen voordat deze in een GridView besturingselement wordt weergegeven.
<%@ 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>
Opmerkingen
Voordat het GridView besturingselement kan worden weergegeven, moet elke rij in het besturingselement zijn gebonden aan een record in de gegevensbron. De RowDataBound gebeurtenis wordt gegenereerd wanneer een gegevensrij (vertegenwoordigd door een GridViewRow object) is gebonden aan gegevens in het GridView besturingselement. Hiermee kunt u een methode voor gebeurtenisafhandeling opgeven waarmee een aangepaste routine wordt uitgevoerd, zoals het wijzigen van de waarden van de gegevens die aan de rij zijn gebonden, wanneer deze gebeurtenis zich voordoet.
Een GridViewRowEventArgs object wordt doorgegeven aan de methode voor gebeurtenisafhandeling, waarmee u toegang hebt tot de eigenschappen van de rij die wordt gebonden. Als u toegang wilt krijgen tot een specifieke cel in de rij, gebruikt u de Cells eigenschap van het GridViewRow object in de Row eigenschap van het GridViewRowEventArgs object. U kunt bepalen welk rijtype (veldnamenrij, gegevensrij enzovoort) afhankelijk is van de RowType eigenschap.
Zie Gebeurtenissen verwerken en genereren voor meer informatie over het afhandelen van gebeurtenissen.
