.NET Framework Class Library GridViewRowCollection Class
Inheritance Hierarchy
Namespace:
System.Web.UI.WebControls
Assembly:
System.Web (in System.Web.dll)
Syntax
Public Class GridViewRowCollection _
Implements ICollection, IEnumerable
public class GridViewRowCollection : ICollection,
IEnumerable
public ref class GridViewRowCollection : ICollection,
IEnumerable
type GridViewRowCollection =
class
interface ICollection
interface IEnumerable
end
The GridViewRowCollection type exposes the following members.
Constructors
Methods
Extension Methods
Explicit Interface Implementations
Remarks
The GridViewRowCollection class is used to store and manage a collection of GridViewRow objects in a GridView control. Each row in a GridView control is represented by a GridViewRow object. The GridView control stores all of its data rows in the Rows collection. The GridViewRowCollection class supports several ways to access the items in the collection: Use the Item indexer to directly retrieve a GridViewRow object at a specific zero-based index. Use the GetEnumerator method to retrieve an enumerator that can be used to iterate through the collection. 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.
To determine the total number of items in the collection, use the Count property
Examples
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="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 >
<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="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 >
<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>
Version Information
.NET FrameworkSupported in: 4, 3.5, 3.0, 2.0
Platforms
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role not supported), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Thread Safety
Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
See Also
|
Bibliothèque de classes .NET Framework GridViewRowCollection, classe
Hiérarchie d'héritage
Espace de noms :
System.Web.UI.WebControls
Assembly :
System.Web (dans System.Web.dll)
Syntaxe
Public Class GridViewRowCollection _
Implements ICollection, IEnumerable
public class GridViewRowCollection : ICollection,
IEnumerable
public ref class GridViewRowCollection : ICollection,
IEnumerable
type GridViewRowCollection =
class
interface ICollection
interface IEnumerable
end
Le type GridViewRowCollection expose les membres suivants.
Constructeurs
Méthodes
Méthodes d'extension
Implémentations d'interface explicite
Notes
La classe GridViewRowCollection est utilisée pour stocker et gérer une collection d'objets GridViewRow dans un contrôle GridView. Chaque ligne d'un contrôle GridView est représentée par un objet GridViewRow. Le contrôle GridView stocke toutes ses lignes de données dans la collection Rows. La classe GridViewRowCollection prend en charge plusieurs modes d'accès aux éléments de la collection : Utilisez l'indexeur Item pour récupérer directement un objet GridViewRow à un index de base zéro spécifique. Utilisez la méthode GetEnumerator afin de récupérer un énumérateur pouvant être utilisé pour itérer au sein de la collection. Utilisez la méthode CopyTo pour copier les éléments de la collection dans un objet System..::.Array, qui peut ensuite être utilisé pour accéder aux éléments de la collection.
Utilisez la propriété Count pour déterminer le nombre total d'éléments de la collection.
Exemples
L'exemple suivant montre comment itérer au sein de la collection Rows d'un contrôle GridView et afficher les valeurs d'une colonne sur la page.
<%@ 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 >
<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="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 >
<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>
Informations de version
.NET FrameworkPris en charge dans : 4, 3.5, 3.0, 2.0
Plateformes
Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2
Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
Sécurité des threads
Tous les membres static ( Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.
Voir aussi
|