DataGridItem.ItemType Property
Gets the type of the item represented by the DataGridItem object in the DataGrid control.
[Visual Basic] Public Overridable ReadOnly Property ItemType As ListItemType [C#] public virtual ListItemType ItemType {get;} [C++] public: __property virtual ListItemType get_ItemType(); [JScript] public function get ItemType() : ListItemType;
Property Value
One of the ListItemType values.
Remarks
Use the ItemType property to determine the type of an item in the DataGrid control. The following table lists the various item types.
| Item Type | Description |
|---|---|
| Header | The heading section of the DataGrid control. |
| Footer | The footer section of the DataGrid control. |
| Item | An item in the DataGrid control. |
| AlternatingItem | An alternating item in the DataGrid control. |
| SelectedItem | The selected item in the DataGrid control. |
| EditItem | The item selected for editing in the DataGrid control. |
| Separator | A separator between the items of the DataGrid control. |
| Pager | The page selection section of the DataGrid control. |
Example
[Visual Basic, C#] The following example demonstrates how to use the ItemType property to determine the item type of an item in the DataGrid control. The order that items are created in the DataGrid control is displayed along with the item type.
[Visual Basic, C#] Note The following code sample uses the single-file code model and may not work correctly if copied directly into a code-behind file. This code sample must be copied into an empty text file that has an .aspx extension. For more information on the Web Forms code model, see Web Forms Code Model.
[Visual Basic] <%@ 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 10 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 Item_Bound(sender As Object, e As DataGridItemEventArgs) ' Use the ItemDataBound event to customize the DataGrid control. ' The ItemDataBound event allows you to access the data before ' the item is displayed in the control. In this example, the ' ItemDataBound event is used to format the items in the ' CurrencyColumn in currency format. If e.Item.ItemType = ListItemType.Item Or _ e.Item.ItemType = ListItemType.AlternatingItem Then ' Retrieve the text of the CurrencyColumn from the DataGridItem ' and convert the value to a Double. Dim Price As Double = Convert.ToDouble(e.Item.Cells(2).Text) ' Format the value as currency and redisplay it in the DataGrid. e.Item.Cells(2).Text = Price.ToString("c") End If End Sub </script> <body> <form runat=server> <h3>DataGrid ItemDataBound Example</h3> <asp:DataGrid id="ItemsGrid" runat="server" BorderColor="black" BorderWidth="1" CellPadding="3" ShowFooter="true" OnItemDataBound="Item_Bound"> <HeaderStyle BackColor="#00aaaa"> </HeaderStyle> <FooterStyle BackColor="#00aaaa"> </FooterStyle> </asp:DataGrid> </form> </body> </html> [C#] <%@ Page Language="C#" AutoEventWireup="True" Debug="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<=10; 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 Item_Bound(Object sender, DataGridItemEventArgs e) { // Use the ItemDataBound event to customize the DataGrid control. // The ItemDataBound event allows you to access the data before // the item is displayed in the control. In this example, the // ItemDataBound event is used to format the items in the // CurrencyColumn in currency format. if((e.Item.ItemType == ListItemType.Item) || (e.Item.ItemType == ListItemType.AlternatingItem)) { // Retrieve the text of the CurrencyColumn from the DataGridItem // and convert the value to a Double. Double Price = Convert.ToDouble(e.Item.Cells[2].Text); // Format the value as currency and redisplay it in the DataGrid. e.Item.Cells[2].Text = Price.ToString("c"); } } </script> <body> <form runat=server> <h3>DataGrid ItemDataBound Example</h3> <asp:DataGrid id="ItemsGrid" runat="server" BorderColor="black" BorderWidth="1" CellPadding="3" ShowFooter="true" OnItemDataBound="Item_Bound"> <HeaderStyle BackColor="#00aaaa"> </HeaderStyle> <FooterStyle BackColor="#00aaaa"> </FooterStyle> </asp:DataGrid> </form> </body> </html>
[C++, JScript] No example is available for C++ or JScript. To view a Visual Basic or C# example, click the Language Filter button
in the upper-left corner of the page.
Requirements
Platforms: Windows 2000, Windows XP Professional, Windows Server 2003 family
See Also
DataGridItem Class | DataGridItem Members | System.Web.UI.WebControls Namespace | DataGrid | ListItemType