GridViewRowCollection.GetEnumerator メソッド
メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。 GridViewRowCollection 内のすべての GridViewRow オブジェクトを格納している列挙子を返します。
名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文
戻り値
GridViewRowCollection のすべての GridViewRow オブジェクトを格納している System.Collections.IEnumerator 実装オブジェクト。
解説
使用例
プラットフォーム
バージョン情報
参照
アセンブリ: System.Web (system.web.dll 内)
構文Dim instance As GridViewRowCollection Dim returnValue As IEnumerator returnValue = instance.GetEnumerator
public IEnumerator GetEnumerator ()
public: virtual IEnumerator^ GetEnumerator () sealed
public final IEnumerator GetEnumerator ()
public final function GetEnumerator () : IEnumerator
GridViewRowCollection のすべての GridViewRow オブジェクトを格納している System.Collections.IEnumerator 実装オブジェクト。
解説このメソッドを使用して、GridViewRowCollection 内の各項目に直接アクセスするために反復処理できる列挙子を取得します。列挙子の現在の位置の項目にアクセスするには、IEnumerator.Current プロパティを使用します。IEnumerator.MoveNext メソッドを使用して、コレクション内の次の項目に移動します。列挙子を最初の位置まで移動するには、IEnumerator.Reset メソッドを使用します。
.gif) メモ |
|---|
| 最初に列挙子を取得した場合、または IEnumerator.Reset メソッドを使用して列挙子をコレクションの最初の項目に移動した場合は、IEnumerator.MoveNext メソッドを呼び出す必要があります。このメソッドを呼び出さないと、IEnumerator.Current プロパティで表される項目は未定義になります。 |
使用例GetEnumerator メソッドを使用して、コレクションの値を格納している列挙子を取得する方法を次の例に示します。この列挙子が反復処理され、最初のセルの値がページに表示されます。
<%@ Page language="VB" %> <script runat="server"> Sub AuthorsGridView_RowCreated(ByVal sender As Object, ByVal e As GridViewRowEventArgs) If e.Row.RowType = DataControlRowType.Footer Then Message.Text = "The authors are:<br>" ' Get the enumerator that contains the data rows in the ' GridView control. Dim rowEnumerator As IEnumerator = AuthorsGridView.Rows.GetEnumerator() ' Iterate though the enumerator and display the value in the ' first cell of the row. While rowEnumerator.MoveNext() Dim row As GridViewRow = CType(rowEnumerator.Current, GridViewRow) Message.Text &= row.Cells(0).Text & "<br>" End While End If End Sub </script> <html> <body> <form runat="server"> <h3>GridViewRowCollection GetEnumerator 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#" %> <script runat="server"> void AuthorsGridView_RowCreated(Object sender, GridViewRowEventArgs e) { if (e.Row.RowType == DataControlRowType.Footer) { Message.Text = "The authors are:<br>"; // Get the enumerator that contains the data rows in the // GridView control. IEnumerator rowEnumerator = AuthorsGridView.Rows.GetEnumerator(); // Iterate though the enumerator and display the value in the // first cell of the row. while(rowEnumerator.MoveNext()) { GridViewRow row = (GridViewRow)rowEnumerator.Current; Message.Text += row.Cells[0].Text + "<br>"; } } } </script> <html> <body> <form runat="server"> <h3>GridViewRowCollection GetEnumerator 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>
プラットフォームWindows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照- GridViewRowCollection.GetEnumerator メソッドのページへのリンク
