DetailsViewRowCollection クラス
メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。 DetailsView コントロール内の DetailsViewRow オブジェクトのコレクションを表します。 名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文
解説
使用例
.NET Framework のセキュリティ
継承階層
スレッド セーフ
プラットフォーム
バージョン情報
参照
アセンブリ: System.Web (system.web.dll 内)
構文解説DetailsViewRowCollection クラスは、DetailsView コントロール内の DetailsViewRow オブジェクトのコレクションを格納および管理する場合に使用されます。DetailsView コントロール内の各行は DetailsViewRow オブジェクトで表されます。DetailsView コントロールは、その Rows プロパティに対して DetailsViewRowCollection クラスを使用します。
.gif) メモ |
|---|
| Rows プロパティには、データ行だけが格納されます。ヘッダー行、フッター行、上部のページ行、および下部のページ行にアクセスするには、それぞれ HeaderRow、FooterRow、TopPagerRow、および BottomPagerRow の各プロパティを使用します。 |
DetailsViewRowCollection クラスは、コレクション内の項目にアクセスするための複数の方法をサポートしています。
使用例DetailsView コントロールの Rows コレクション内の DetailsViewRow オブジェクトを反復処理する方法のコード例を次に示します。このコード例では、各行の値がページに表示されます。
<%@ page language="VB" %> <script runat="server"> Sub SubmitButton_Click(ByVal sender As Object, ByVal e As EventArgs) ' Use the Count property to determine whether the ' Rows collection contains any item. If ItemDetailsView.Rows.Count > 0 Then ' Iterate through the Rows collection and display ' the value of each field. MessageLabel.Text = "The row values are: <br/><br/>" Dim row As DetailsViewRow For Each row In ItemDetailsView.Rows ' Use the Text property to access the value of ' each cell. In this example, the cells in the ' first column (index 0) contains the field names, ' while the cells in the second column (index 1) ' contains the field value. MessageLabel.Text &= row.Cells(0).Text & " = " & _ row.Cells(1).Text & "<br/>" Next Else MessageLabel.Text = "No items." End If End Sub </script> <html> <body> <form runat="server"> <h3>DetailsViewRowCollection Example</h3> <asp:detailsview id="ItemDetailsView" datasourceid="DetailsViewSource" allowpaging="true" autogeneraterows="false" runat="server"> <fields> <asp:boundfield datafield="CustomerID" headertext="Customer ID"/> <asp:boundfield datafield="CompanyName" headertext="Company Name"/> <asp:boundfield datafield="Address" headertext="Address"/> <asp:boundfield datafield="City" headertext="City"/> <asp:boundfield datafield="PostalCode" headertext="ZIP Code"/> <asp:boundfield datafield="Country" headertext="Country"/> </fields> </asp:detailsview> <br/> <asp:button id="SubmitButton" text="Display Row Values" onclick="SubmitButton_Click" runat="server"/> <br/><br/> <asp:label id="MessageLabel" forecolor="Red" runat="server"/> <!-- 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="DetailsViewSource" selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]" connectionstring= "<%$ ConnectionStrings:NorthWindConnectionString%>" runat="server"/> </form> </body> </html>
<%@ page language="C#" %> <script runat="server"> void SubmitButton_Click(Object sender, EventArgs e) { // Use the Count property to determine whether the // Rows collection contains any item. if (ItemDetailsView.Rows.Count > 0) { // Iterate through the Rows collection and display // the value of each field. MessageLabel.Text = "The row values are: <br/><br/>"; foreach (DetailsViewRow row in ItemDetailsView.Rows) { // Use the Text property to access the value of // each cell. In this example, the cells in the // first column (index 0) contains the field names, // while the cells in the second column (index 1) // contains the field value. MessageLabel.Text += row.Cells[0].Text + " = " + row.Cells[1].Text + "<br/>"; } } else { MessageLabel.Text = "No items."; } } </script> <html> <body> <form runat="server"> <h3>DetailsViewRowCollection Example</h3> <asp:detailsview id="ItemDetailsView" datasourceid="DetailsViewSource" allowpaging="true" autogeneraterows="false" runat="server"> <fields> <asp:boundfield datafield="CustomerID" headertext="Customer ID"/> <asp:boundfield datafield="CompanyName" headertext="Company Name"/> <asp:boundfield datafield="Address" headertext="Address"/> <asp:boundfield datafield="City" headertext="City"/> <asp:boundfield datafield="PostalCode" headertext="ZIP Code"/> <asp:boundfield datafield="Country" headertext="Country"/> </fields> </asp:detailsview> <br/> <asp:button id="SubmitButton" text="Display Row Values" onclick="SubmitButton_Click" runat="server"/> <br/><br/> <asp:label id="MessageLabel" forecolor="Red" runat="server"/> <!-- 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="DetailsViewSource" selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]" connectionstring= "<%$ ConnectionStrings:NorthWindConnectionString%>" runat="server"/> </form> </body> </html>
.NET Framework のセキュリティ継承階層 System.Object
System.Web.UI.WebControls.DetailsViewRowCollection
System.Web.UI.WebControls.DetailsViewRowCollection
スレッド セーフプラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照- DetailsViewRowCollection クラスのページへのリンク
