DataGridItemCollection クラス
DataGrid コントロール内の DataGridItem オブジェクトのコレクションを表します。 名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文
解説
使用例
.NET Framework のセキュリティ
継承階層
スレッド セーフ
プラットフォーム
バージョン情報
参照
アセンブリ: System.Web (system.web.dll 内)
構文解説DataGridItemCollection クラスは DataGridItem オブジェクトのコレクションを表し、このオブジェクトは DataGrid コントロールのデータ項目を順番に表します。プログラムによって DataGrid コントロールから DataGridItem オブジェクトを取得するには、次のメソッドのいずれかを使用します。
-
CopyTo メソッドを使用して、コレクションの内容を System.Array にコピーします。その後、このオブジェクトを使用して、コレクションから項目を取得できます。
-
GetEnumerator メソッドを使用して System.Collections.IEnumerator インターフェイスを作成します。その後、このインターフェイスを使用して、コレクションから項目を取得できます。
Count プロパティは、コレクション内の合計項目数を指定します。通常は、コレクションの上限を判断するために使用されます。
使用例DataGridItemCollection コレクション内の DataGridItem オブジェクトを反復処理する方法を次のコード例に示します。
<%@ Page Language="VB" AutoEventWireup="True" %> <%@ Import Namespace="System.Data" %> <html> <script runat="server"> Function CreateDataSource() As ICollection ' Create sample data for the DataGrid control. Dim dt As DataTable = New DataTable() Dim dr As DataRow ' Define the columns of the table. dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32))) dt.Columns.Add(New DataColumn("StringValue", GetType(string))) dt.Columns.Add(New DataColumn("CurrencyValue", GetType(double))) ' Populate the table with sample values. Dim i As Integer For i = 0 to 4 dr = dt.NewRow() dr(0) = i dr(1) = "Item " & i.ToString() dr(2) = 1.23 * (i + 1) dt.Rows.Add(dr) Next i Dim dv As DataView = New DataView(dt) Return dv End Function Sub Page_Load(sender As Object, e As EventArgs) ' Load sample data only once, when the page is first loaded. If Not IsPostBack Then ItemsGrid.DataSource = CreateDataSource() ItemsGrid.DataBind() End If End Sub Sub Button_Click(sender As Object, e As EventArgs) ' Count the number of selected items in the DataGrid control. Dim count As Integer = 0 ' Display the selected times. Message.Text = "You Selected: <br>" ' Iterate through each item (row) in the DataGrid control and ' determine whether it is selected. Dim item As DataGridItem For Each item In ItemsGrid.Items DetermineSelection(item, count) Next ' If no items are selected, display the appropriate message. If count = 0 Then Message.Text = "No items selected" End If End Sub Sub DetermineSelection(item As DataGridItem, ByRef count As Integer) ' Retrieve the SelectCheckBox CheckBox control from the ' specified item (row) in the DataGrid control. Dim selection As CheckBox = _ CType(item.FindControl("SelectCheckBox"), CheckBox) ' If the item is selected, display the appropriate message and ' increment the count of selected items. If Not selection Is Nothing Then If selection.Checked Then Message.Text &= "- " & item.Cells(1).Text & "<br>" count = count + 1 End If End If End Sub Sub Check_Change(sender As Object, e As EventArgs) ' Show or hide the first column depending on the value of ' the check box. If ShowCheckBox.Checked Then ItemsGrid.Columns(0).Visible = True Else ItemsGrid.Columns(0).Visible = False End If End Sub </script> <body> <form runat=server> <h3>DataGridColumn Visible Example</h3> Select whether to show or hide the first column. <br><br> <b>Product List</b> <asp:DataGrid id="ItemsGrid" BorderColor="black" BorderWidth="1" CellPadding="3" ShowFooter="True" AutoGenerateColumns="False" runat="server"> <HeaderStyle BackColor="#00aaaa"> </HeaderStyle> <FooterStyle BackColor="#00aaaa"> </FooterStyle> <Columns> <asp:BoundColumn DataField="IntegerValue" Visible="True" HeaderText="Item"/> <asp:BoundColumn DataField="StringValue" Visible="True" HeaderText="Description"/> <asp:BoundColumn DataField="CurrencyValue" Visible="True" HeaderText="Price" DataFormatString="{0:c}"> <ItemStyle HorizontalAlign="Right"> </ItemStyle> </asp:BoundColumn> <asp:TemplateColumn HeaderText="Select Item" Visible="True" > <ItemTemplate> <asp:CheckBox id="SelectCheckBox" Text="Add to Cart" Checked="False" runat="server"/> </ItemTemplate> </asp:TemplateColumn> </Columns> </asp:DataGrid> <br><br> <asp:Button id="SubmitButton" Text="Submit" OnClick = "Button_Click" runat="server"/> <br><br> <asp:Label id="Message" runat="server"/> <hr> <asp:CheckBox id="ShowCheckBox" Text="Show first column" AutoPostBack="True" OnCheckedChanged="Check_Change" Checked="True" runat="server"/> </form> </body> </html>
<%@ Page Language="C#" AutoEventWireup="True" %> <%@ Import Namespace="System.Data" %> <html> <script runat="server"> ICollection CreateDataSource() { // Create sample data for the DataGrid control. DataTable dt = new DataTable(); DataRow dr; // Define the columns of the table. dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32))); dt.Columns.Add(new DataColumn("StringValue", typeof(string))); dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double))); // Populate the table with sample values. for (int i = 0; i < 5; i++) { dr = dt.NewRow(); dr[0] = i; dr[1] = "Item " + i.ToString(); dr[2] = 1.23 * (i + 1); dt.Rows.Add(dr); } DataView dv = new DataView(dt); return dv; } void Page_Load(Object sender, EventArgs e) { // Load sample data only once, when the page is first loaded. if (!IsPostBack) { ItemsGrid.DataSource = CreateDataSource(); ItemsGrid.DataBind(); } } void Button_Click(Object sender, EventArgs e) { // Count the number of selected items in the DataGrid control. int count = 0; // Display the selected times. Message.Text = "You Selected: <br>"; // Iterate through each item (row) in the DataGrid control and // determine whether it is selected. foreach (DataGridItem item in ItemsGrid.Items) { DetermineSelection(item, ref count); } // If no items are selected, display the appropriate message. if (count == 0) { Message.Text = "No items selected"; } } void DetermineSelection(DataGridItem item, ref int count) { // Retrieve the SelectCheckBox CheckBox control from the // specified item (row) in the DataGrid control. CheckBox selection = (CheckBox)item.FindControl("SelectCheckBox"); // If the item is selected, display the appropriate message and // increment the count of selected items. if (selection != null) { if (selection.Checked) { Message.Text += "- " + item.Cells[1].Text + "<br>"; count++; } } } void Check_Change(Object sender, EventArgs e) { // Show or hide the first column depending on the value of // the check box. if (ShowCheckBox.Checked) { ItemsGrid.Columns[0].Visible = true; } else { ItemsGrid.Columns[0].Visible = false; } } </script> <body> <form runat=server> <h3>DataGridColumn Visible Example</h3> Select whether to show or hide the first column. <br><br> <b>Product List</b> <asp:DataGrid id="ItemsGrid" BorderColor="black" BorderWidth="1" CellPadding="3" ShowFooter="True" AutoGenerateColumns="False" runat="server"> <HeaderStyle BackColor="#00aaaa"> </HeaderStyle> <FooterStyle BackColor="#00aaaa"> </FooterStyle> <Columns> <asp:BoundColumn DataField="IntegerValue" Visible="True" HeaderText="Item"/> <asp:BoundColumn DataField="StringValue" Visible="True" HeaderText="Description"/> <asp:BoundColumn DataField="CurrencyValue" Visible="True" HeaderText="Price" DataFormatString="{0:c}"> <ItemStyle HorizontalAlign="Right"> </ItemStyle> </asp:BoundColumn> <asp:TemplateColumn HeaderText="Select Item" Visible="True" > <ItemTemplate> <asp:CheckBox id="SelectCheckBox" Text="Add to Cart" Checked="False" runat="server"/> </ItemTemplate> </asp:TemplateColumn> </Columns> </asp:DataGrid> <br><br> <asp:Button id="SubmitButton" Text="Submit" OnClick = "Button_Click" runat="server"/> <br><br> <asp:Label id="Message" runat="server"/> <hr> <asp:CheckBox id="ShowCheckBox" Text="Show first column" AutoPostBack="True" OnCheckedChanged="Check_Change" Checked="True" runat="server"/> </form> </body> </html>
.NET Framework のセキュリティ継承階層 System.Object
System.Web.UI.WebControls.DataGridItemCollection
System.Web.UI.WebControls.DataGridItemCollection
スレッド セーフプラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照DataGridItemCollection コンストラクタ
DataGridItemCollection クラスの新しいインスタンスを初期化します。 名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文
解説
プラットフォーム
バージョン情報
参照
アセンブリ: System.Web (system.web.dll 内)
構文解説プラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照DataGridItemCollection プロパティ
パブリック プロパティ| 名前 | 説明 | |
|---|---|---|
.gif) | Count | コレクション内の DataGridItem オブジェクト数を取得します。 |
| | IsReadOnly | DataGridItemCollection コレクション内の DataGridItem オブジェクトを変更できるかどうかを示す値を取得します。 |
| | IsSynchronized | DataGridItemCollection コレクションへのアクセスが同期されている (スレッド セーフである) かどうかを示す値を取得します。 |
| | Item | コレクション内の指定したインデックス位置の DataGridItem オブジェクトを取得します。 |
| | SyncRoot | DataGridItemCollection コレクションへのアクセスを同期するために使用できるオブジェクトを取得します。 |
参照DataGridItemCollection メソッド
パブリック メソッド ( プロテクト メソッド も参照)
| 名前 | 説明 | |
|---|---|---|
.gif) | CopyTo | 指定した System.Array にこの DataGridItemCollection コレクションのすべての項目をコピーします。コピー操作は、System.Array 内の指定したインデックス位置から始まります。 |
| | Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。) |
| | GetEnumerator | DataGridItemCollection コレクションのすべての DataGridItem オブジェクトを格納する System.Collections.IEnumerator 実装オブジェクトを返します。 |
| | GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。) |
| | GetType | 現在のインスタンスの Type を取得します。 ( Object から継承されます。) |
.gif) | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。) |
| | ToString | 現在の Object を表す String を返します。 ( Object から継承されます。) |
プロテクト メソッド| 名前 | 説明 | |
|---|---|---|
.gif) | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。) |
| | MemberwiseClone | 現在の Object の簡易コピーを作成します。 ( Object から継承されます。) |
参照DataGridItemCollection メンバ
DataGrid コントロール内の DataGridItem オブジェクトのコレクションを表します。
DataGridItemCollection データ型で公開されるメンバを以下の表に示します。
パブリック コンストラクタパブリック プロパティ| 名前 | 説明 | |
|---|---|---|
| | Count | コレクション内の DataGridItem オブジェクト数を取得します。 |
| | IsReadOnly | DataGridItemCollection コレクション内の DataGridItem オブジェクトを変更できるかどうかを示す値を取得します。 |
| | IsSynchronized | DataGridItemCollection コレクションへのアクセスが同期されている (スレッド セーフである) かどうかを示す値を取得します。 |
| | Item | コレクション内の指定したインデックス位置の DataGridItem オブジェクトを取得します。 |
| | SyncRoot | DataGridItemCollection コレクションへのアクセスを同期するために使用できるオブジェクトを取得します。 |
パブリック メソッド ( プロテクト メソッド も参照)
| 名前 | 説明 | |
|---|---|---|
| | CopyTo | 指定した System.Array にこの DataGridItemCollection コレクションのすべての項目をコピーします。コピー操作は、System.Array 内の指定したインデックス位置から始まります。 |
| | Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。) |
| | GetEnumerator | DataGridItemCollection コレクションのすべての DataGridItem オブジェクトを格納する System.Collections.IEnumerator 実装オブジェクトを返します。 |
| | GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。) |
| | GetType | 現在のインスタンスの Type を取得します。 (Object から継承されます。) |
| | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。) |
| | ToString | 現在の Object を表す String を返します。 (Object から継承されます。) |
プロテクト メソッド| 名前 | 説明 | |
|---|---|---|
| | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。) |
| | MemberwiseClone | 現在の Object の簡易コピーを作成します。 (Object から継承されます。) |
参照- DataGridItemCollectionのページへのリンク
