ListItemType Enumeration
Collapse the table of content
Expand the table of content

ListItemType Enumeration

Specifies the type of an item in a list control.

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

public enum ListItemType

Member nameDescription
AlternatingItemAn item in alternating (zero-based even-indexed) cells. It is data-bound.
EditItemAn item in a list control currently in edit mode. It is data-bound.
FooterA footer for the list control. It is not data-bound.
HeaderA header for the list control. It is not data-bound.
ItemAn item in the list control. It is data-bound.
PagerA pager that displays the controls to navigate to different pages associated with the DataGrid control. It is not data-bound.
SelectedItemA selected item in the list control. It is data-bound.
SeparatorA separator between items in a list control. It is not data-bound.

The ListItemType enumeration represents the different items that can be included in a list control, such as the DataGrid, DataList, and Repeater controls. A typical list control consists of cells that contain elements represented by this enumeration.

<%@ Page Language="C#" AutoEventWireup="True" Debug="true" %>
<%@ Import Namespace="System.Data" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
<html xmlns="" >
   <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);



         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();



      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");




<head runat="server">
    <title>DataGrid ItemDataBound Example</title>

   <form id="form1" runat="server">

      <h3>DataGrid ItemDataBound Example</h3>

      <asp:DataGrid id="ItemsGrid" runat="server"

         <HeaderStyle BackColor="#00aaaa">

         <FooterStyle BackColor="#00aaaa">




.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1
© 2015 Microsoft