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
public enum ListItemType
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">


Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0