This documentation is archived and is not being maintained.
ListItemType Enumeration
.NET Framework 1.1
Specifies the type of an item in a list control.
[Visual Basic] <Serializable> Public Enum ListItemType [C#] [Serializable] public enum ListItemType [C++] [Serializable] __value public enum ListItemType [JScript] public Serializable enum ListItemType
Remarks
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.
Members
| Member name | Description |
|---|---|
| AlternatingItem | An item in alternating (zero-based even-indexed) cells. It is data-bound. |
| EditItem | An item in a list control currently in edit mode. It is data-bound. |
| Footer | A footer for the list control. It is not data-bound. |
| Header | A header for the list control. It is not data-bound. |
| Item | An item in the list control. It is data-bound. |
| Pager | A pager that displays the controls to navigate to different pages associated with the DataGrid control. It is not data-bound. |
| SelectedItem | A selected item in the list control. It is data-bound. |
| Separator | A separator between items in a list control. It is not data-bound. |
Example
[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
Namespace: System.Web.UI.WebControls
Platforms: Windows 2000, Windows XP Professional, Windows Server 2003 family
Assembly: System.Web (in System.Web.dll)
See Also
System.Web.UI.WebControls Namespace | DataGridItem.ItemType | DataListItem.ItemType | RepeaterItem.ItemType
Show: