Поделиться через


GridViewRowEventArgs Класс

Определение

Предоставляет данные для событий RowCreated и RowDataBound .

public ref class GridViewRowEventArgs : EventArgs
public class GridViewRowEventArgs : EventArgs
type GridViewRowEventArgs = class
    inherit EventArgs
Public Class GridViewRowEventArgs
Inherits EventArgs
Наследование
GridViewRowEventArgs

Примеры

В следующем примере показано, как использовать объект, переданный GridViewRowEventArgs методу обработки событий, для доступа к свойствам строки, привязанной к данным.


<%@ 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 Перед отрисовкой GridViewRow элемента управления необходимо создать объект для каждой строки в элементе управления . Событие RowCreated возникает при каждом создании строки в элементе GridView управления . Это позволяет предоставить метод обработки событий, который выполняет настраиваемую подпрограмму, например добавление пользовательского содержимого в строку, при каждом возникновении этого события.

Аналогичным образом, перед отрисовкой элемента управления каждая строка в элементе управления должна быть привязана к записи в источнике GridView данных. Событие RowDataBound возникает, когда строка данных (представленная GridViewRow объектом) привязана к данным в элементе GridView управления . Это позволяет предоставить метод обработки событий, который выполняет пользовательскую подпрограмму, например изменение значений данных, привязанных к строке, при каждом возникновении этого события.

Объект GridViewRowEventArgs передается методу обработки событий, что позволяет получить доступ к свойствам строки, вызваввшей событие. Чтобы получить доступ к определенной ячейке в строке Cells , используйте свойство GridViewRow объекта , содержащегося в свойстве Row . Вы также можете определить, какой тип строки (строка заголовка, строка данных и т. д.) создается с помощью RowType свойства GridViewRow объекта .

Дополнительные сведения об обработке событий см. в разделе Обработка и создание событий.

Список начальных значений свойств для экземпляра GridViewRowEventArgsсм. в конструкторе GridViewRowEventArgs .

Конструкторы

GridViewRowEventArgs(GridViewRow)

Инициализирует новый экземпляр класса GridViewRowEventArgs.

Свойства

Row

Возвращает создаваемую или привязываемую к данным строку.

Методы

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)

Применяется к

См. также раздел