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

GridViewRowEventArgs Класс

Определение

Пространство имен:
System.Web.UI.WebControls
Сборка:
System.Web.dll

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

public ref class GridViewRowEventArgs : EventArgs
public class GridViewRowEventArgs : EventArgs
type GridViewRowEventArgs = class
    inherit EventArgs
Public Class GridViewRowEventArgs
Inherits EventArgs
Наследование
Object
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)

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

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