GridViewRowCollection Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет коллекцию GridViewRow объектов в элементе GridView управления.
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 элемента управления и отображать значения столбца на странице.
<%@ 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 . Каждая строка элемента GridView управления представлена GridViewRow объектом. Элемент GridView управления хранит все строки данных в Rows коллекции.
Класс GridViewRowCollection поддерживает несколько способов доступа к элементам в коллекции:
Item[] Используйте индексатор для непосредственного получения GridViewRow объекта в определенном отсчитываемом от нуля индексе.
GetEnumerator Используйте метод для получения перечислителя, который можно использовать для итерации через коллекцию.
CopyTo Используйте метод для копирования элементов в коллекцию в System.Array объект, который затем можно использовать для доступа к элементам в коллекции.
Чтобы определить общее количество элементов в коллекции, используйте Count свойство
Конструкторы
| Имя | Описание |
|---|---|
| GridViewRowCollection(ArrayList) |
Инициализирует новый экземпляр класса с помощью указанного GridViewRowCollectionArrayList объекта. |
Свойства
| Имя | Описание |
|---|---|
| Count |
Возвращает количество элементов в объекте GridViewRowCollection . |
| IsReadOnly |
Возвращает значение, указывающее, можно ли изменять строки в объекте GridViewRowCollection . |
| IsSynchronized |
Возвращает значение, указывающее, синхронизирован ли GridViewRowCollection объект (потокобезопасный). |
| Item[Int32] |
Возвращает объект GridViewRow по указанному индексу. |
| SyncRoot |
Возвращает объект, используемый для синхронизации доступа к коллекции. |
Методы
| Имя | Описание |
|---|---|
| CopyTo(GridViewRow[], Int32) |
Копирует все элементы из этого GridViewRowCollection объекта в указанный объект, начиная с указанного Array индекса в объекте Array . |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetEnumerator() |
Возвращает перечислитель, содержащий все GridViewRow объекты в объекте GridViewRowCollection. |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
Явные реализации интерфейса
| Имя | Описание |
|---|---|
| ICollection.CopyTo(Array, Int32) |
Описание этого элемента см. в разделе CopyTo(Array, Int32). |
Методы расширения
| Имя | Описание |
|---|---|
| AsParallel(IEnumerable) |
Включает параллелизацию запроса. |
| AsQueryable(IEnumerable) |
Преобразует IEnumerable в IQueryable. |
| Cast<TResult>(IEnumerable) |
Приведение элементов IEnumerable к указанному типу. |
| OfType<TResult>(IEnumerable) |
Фильтрует элементы IEnumerable на основе указанного типа. |