GridViewRowEventArgs Класс

Определение

Предоставляет данные для событий RowCreated и RowDataBound.Provides data for the RowCreated and RowDataBound events.

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

Примеры

В следующем примере показано, как использовать объект GridViewRowEventArgs , переданный в метод обработки событий, для доступа к свойствам строки, привязанной к данным.The following example demonstrates how to use the GridViewRowEventArgs object passed to the event-handling method to access the properties of the row being bound to data.


<%@ 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>

Комментарии

Перед отображением GridViewRow элемента управления необходимо создать объект для каждой строки в элементе управления. GridViewBefore the GridView control can be rendered, a GridViewRow object must be created for each row in the control. Событие возникает при каждом создании строки GridView в элементе управления. RowCreatedThe RowCreated event is raised each time a row in the GridView control is created. Это позволяет предоставить метод обработки событий, выполняющий пользовательскую подпрограммы, например добавление пользовательского содержимого в строку при возникновении этого события.This allows you to provide an event-handling method that performs a custom routine, such as adding custom content to a row, whenever this event occurs.

Аналогичным образом каждая строка в элементе управления должна быть привязана к записи в источнике данных до GridView того, как элемент управления будет готов к просмотру.Similarly, each row in the control must be bound to a record in the data source before the GridView control can be rendered. Событие возникает, когда строка данных (представленная GridViewRow объектом) GridView привязана к данным в элементе управления. RowDataBoundThe RowDataBound event is raised when a data row (represented by a GridViewRow object) is bound to data in the GridView control. Это позволяет предоставить метод обработки событий, выполняющий пользовательскую подпрограммы, например изменение значений данных, привязанных к строке, при каждом возникновении этого события.This allows you to provide an event-handling method that performs a custom routine, such as modifying the values of the data bound to the row, whenever this event occurs.

GridViewRowEventArgs Объект передается в метод обработки событий, который позволяет получить доступ к свойствам строки, вызвавшей событие.A GridViewRowEventArgs object is passed to the event-handling method, which allows you to access the properties of the row that raised the event. Чтобы получить доступ к определенной ячейке в строке, используйте Cells свойство GridViewRow объекта, содержащегося в Row свойстве.To access a specific cell in the row, use the Cells property of the GridViewRow object contained in the Row property. Можно также определить, какой тип строки (строка заголовка, строка данных и т. д.) создается с помощью RowType свойства GridViewRow объекта.You can also determine which row type (header row, data row, and so on) is being created by using the RowType property of the GridViewRow object.

Дополнительные сведения об обработке событий см. в разделе обработка и вызов событий.For more information about how to handle events, see Handling and Raising Events.

Список начальных значений свойств для экземпляра GridViewRowEventArgsсм. в GridViewRowEventArgs разделе Конструктор.For a list of initial property values for an instance of GridViewRowEventArgs, see the GridViewRowEventArgs constructor.

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

GridViewRowEventArgs(GridViewRow)

Инициализирует новый экземпляр класса GridViewRowEventArgs.Initializes a new instance of the GridViewRowEventArgs class.

Свойства

Row

Возвращает создаваемую или привязываемую к данным строку.Gets the row being created or data-bound.

Методы

Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

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

Служит хэш-функцией по умолчанию.Serves as the default hash function.

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

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

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

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

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

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

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

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

Дополнительно