GridView.RowDataBound Событие
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Происходит, когда строка данных привязана к данным в элементе GridView управления.
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 Тип события
Примеры
Проект веб-сайта Visual Studio с исходным кодом доступен для сопровождения этого раздела: скачивание.
В следующем примере показано, как использовать RowDataBound событие для изменения значения поля в источнике данных перед отображением в элементе 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_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>
Комментарии
GridView Перед отрисовкой элемента управления каждая строка в элементе управления должна быть привязана к записи в источнике данных. Событие RowDataBound возникает, когда строка данных (представленная GridViewRow объектом) привязана к данным в элементе GridView управления. Это позволяет предоставить метод обработки событий, выполняющий настраиваемую подпрограмму, например изменение значений данных, привязанных к строке, при каждом возникновении этого события.
GridViewRowEventArgs Объект передается методу обработки событий, который позволяет получить доступ к свойствам привязанной строки. Чтобы получить доступ к определенной ячейке в строке, используйте Cells свойство GridViewRow объекта, содержащегося в Row свойстве GridViewRowEventArgs объекта. Вы можете определить, какой тип строки (строка заголовка, строка данных и т. д.) привязан с помощью RowType свойства.
Дополнительные сведения об обработке событий см. в разделе "Обработка и создание событий".
