GridViewRowEventArgs GridViewRowEventArgs GridViewRowEventArgs GridViewRowEventArgs Class

Определение

Предоставляет данные для событий 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
Наследование
GridViewRowEventArgsGridViewRowEventArgsGridViewRowEventArgsGridViewRowEventArgs

Примеры

Следующий пример демонстрирует, как использовать 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>

Комментарии

Прежде чем GridView можно отобразить элемент управления, GridViewRow объект должен быть создан для каждой строки в элементе управления.Before the GridView control can be rendered, a GridViewRow object must be created for each row in the control. RowCreated Событие вызывается каждый раз, когда строки в GridView создается элемент управления.The 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. RowDataBound Событие возникает, когда строки данных (представленный GridViewRow объекта) привязан к данным в GridView элемента управления.The 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(GridViewRow) GridViewRowEventArgs(GridViewRow) GridViewRowEventArgs(GridViewRow)

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

Свойства

Row Row Row Row

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

Методы

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
ToString() ToString() ToString() ToString()

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

(Inherited from Object)

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

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