GridViewRowCollection Класс

Определение

Представляет коллекцию объектов GridViewRow в элементе управления GridView.Represents a collection of GridViewRow objects in a GridView control.

public ref class GridViewRowCollection : System::Collections::ICollection
public class GridViewRowCollection : System.Collections.ICollection
type GridViewRowCollection = class
    interface ICollection
    interface IEnumerable
Public Class GridViewRowCollection
Implements ICollection
Наследование
GridViewRowCollection
Реализации

Примеры

В следующем примере показано, как выполнить итерацию по Rows коллекции GridView элемента управления и отобразить значения столбца на странице.The following example demonstrates how to iterate through the Rows collection of a GridView control and display the values of a column on the page.


<%@ 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 AuthorsGridView_RowCreated(Object sender, GridViewRowEventArgs e)
  {
    if (e.Row.RowType == DataControlRowType.Footer)
    {      
      
      // Get the number of items in the Rows collection.
      int count = AuthorsGridView.Rows.Count;

      // If the GridView control contains any records, display 
      // the last name of each author in the GridView control.
      if (count > 0)
      {      
        Message.Text = "The authors are:<br />";
        
        foreach (GridViewRow row in AuthorsGridView.Rows)
        {
          Message.Text += row.Cells[0].Text + "<br />";
        }
      }
      
    }
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>GridViewRowCollection Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridViewRowCollection Example</h3>

      <table>
        <tr>
          <td>
            <asp:gridview id="AuthorsGridView" 
              datasourceid="AuthorsSqlDataSource" 
              autogeneratecolumns="false"
              onrowcreated="AuthorsGridView_RowCreated"  
              runat="server"> 
                     
              <columns>
                <asp:boundfield datafield="au_lname"
                  headertext="Last Name"/>
                <asp:boundfield datafield="au_fname"
                  headertext="First Name"/>
              </columns>
                                    
            </asp:gridview>
          </td>
          <td>
            <asp:label id="Message" 
              forecolor="Red"
              runat="server"/>
          </td>
        </tr>
      </table>
            
      <!-- This example uses Microsoft SQL Server and connects -->
      <!-- to the Pubs sample database.                        -->
      <asp:sqldatasource id="AuthorsSqlDataSource"  
        selectcommand="SELECT [au_lname], [au_fname] FROM [authors] WHERE [state]='CA'"
        connectionstring="server=localhost;database=pubs;integrated security=SSPI"
        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 AuthorsGridView_RowCreated(ByVal sender As Object, ByVal e As GridViewRowEventArgs)

    If e.Row.RowType = DataControlRowType.Footer Then
      
      ' Get the number of items in the Rows collection.
      Dim count As Integer = AuthorsGridView.Rows.Count

      ' If the GridView control contains any records, display 
      ' the last name of each author in the GridView control.
      If count > 0 Then
           
        Message.Text = "The authors are:<br />"
        
        Dim row As GridViewRow
        For Each row In AuthorsGridView.Rows
        
          Message.Text &= row.Cells(0).Text & "<br />"
        
        Next
        
      End If
        
    End If
        
  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>GridViewRowCollection Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridViewRowCollection Example</h3>

      <table>
        <tr>
          <td>
            <asp:gridview id="AuthorsGridView" 
              datasourceid="AuthorsSqlDataSource" 
              autogeneratecolumns="false"
              onrowcreated="AuthorsGridView_RowCreated"  
              runat="server"> 
                     
              <columns>
                <asp:boundfield datafield="au_lname"
                  headertext="Last Name"/>
                <asp:boundfield datafield="au_fname"
                  headertext="First Name"/>
              </columns>
                                    
            </asp:gridview>
          </td>
          <td>
            <asp:label id="Message" 
              forecolor="Red"
              runat="server"/>
          </td>
        </tr>
      </table>
            
      <!-- This example uses Microsoft SQL Server and connects -->
      <!-- to the Pubs sample database.                        -->
      <asp:sqldatasource id="AuthorsSqlDataSource"  
        selectcommand="SELECT [au_lname], [au_fname] FROM [authors] WHERE [state]='CA'"
        connectionstring="server=localhost;database=pubs;integrated security=SSPI"
        runat="server">
      </asp:sqldatasource>
          
    </form>
  </body>
</html>

Комментарии

GridViewRowCollectionКласс используется для хранения коллекции объектов и управления ею GridViewRow в GridView элементе управления.The GridViewRowCollection class is used to store and manage a collection of GridViewRow objects in a GridView control. Каждая строка в GridView элементе управления представляется GridViewRow объектом.Each row in a GridView control is represented by a GridViewRow object. GridViewЭлемент управления хранит все строки данных в Rows коллекции.The GridView control stores all of its data rows in the Rows collection.

GridViewRowCollectionКласс поддерживает несколько способов доступа к элементам в коллекции:The GridViewRowCollection class supports several ways to access the items in the collection:

  • Используйте Item[] индексатор для непосредственного извлечения GridViewRow объекта по заданному индексу (от нуля).Use the Item[] indexer to directly retrieve a GridViewRow object at a specific zero-based index.

  • Используйте GetEnumerator метод, чтобы получить перечислитель, который можно использовать для прохода по коллекции.Use the GetEnumerator method to retrieve an enumerator that can be used to iterate through the collection.

  • Используйте CopyTo метод, чтобы скопировать элементы коллекции в System.Array объект, который затем можно использовать для доступа к элементам в коллекции.Use the CopyTo method to copy the items in the collection into an System.Array object, which can then be used to access the items in the collection.

Чтобы определить общее число элементов в коллекции, используйте Count свойствоTo determine the total number of items in the collection, use the Count property

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

GridViewRowCollection(ArrayList)

Инициализирует новый экземпляр класса GridViewRowCollection, используя указанный объект ArrayList.Initializes a new instance of the GridViewRowCollection class using the specified ArrayList object.

Свойства

Count

Возвращает количество элементов в объекте GridViewRowCollection.Gets the number of items in the GridViewRowCollection object.

IsReadOnly

Возвращает значение, показывающее, могут ли изменяться строки в объекте GridViewRowCollection.Gets a value indicating whether the rows in the GridViewRowCollection object can be modified.

IsSynchronized

Возвращает значение, которое показывает, является ли объект GridViewRowCollection синхронизированным (потокобезопасным).Gets a value indicating whether the GridViewRowCollection object is synchronized (thread-safe).

Item[Int32]

Возвращает объект GridViewRow по указанному индексу.Gets the GridViewRow object at the specified index.

SyncRoot

Получает объект, используемый для синхронизации доступа к коллекции.Gets the object used to synchronize access to the collection.

Методы

CopyTo(GridViewRow[], Int32)

Копирует все элементы из данного класса GridViewRowCollection в указанный объект Array, начиная с указанного индекса в объекте Array.Copies all the items from this GridViewRowCollection to the specified Array object, starting at the specified index in the Array object.

Equals(Object)

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

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

Возвращает перечислитель, содержащий все объекты GridViewRow в коллекции GridViewRowCollection.Returns an enumerator that contains all GridViewRow objects in the GridViewRowCollection.

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)

Явные реализации интерфейса

ICollection.CopyTo(Array, Int32)

Описание этого члена см. в разделе CopyTo(Array, Int32).For a description of this member, see CopyTo(Array, Int32).

Методы расширения

Cast<TResult>(IEnumerable)

Приводит элементы объекта IEnumerable к заданному типу.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Выполняет фильтрацию элементов объекта IEnumerable по заданному типу.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Позволяет осуществлять параллельный запрос.Enables parallelization of a query.

AsQueryable(IEnumerable)

Преобразовывает коллекцию IEnumerable в объект IQueryable.Converts an IEnumerable to an IQueryable.

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

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