System.Web.UI.WebControls Namespace   DataList Class

---

Occurs when an item is created in the DataList control.

[ VB ]
Public Event ItemCreated As DataListItemEventHandler

[ C# ]
public event DataListItemEventHandler ItemCreated;

[ C++ ]
public: __event DataListItemEventHandler* ItemCreated;

In [ JScript ], you can handle the events defined by a class, but you cannot define your own.

The ItemCreated event is raised whenever an item in the DataList is created.

This event provides an opportunity to access each item ( or row ) before the page is finally sent to the client for display. After this event is raised, the item is then bound to data and the ItemDataBound event in turn is raised, after which the data item is nulled out and no longer available.

This event is raised for the header, the footer, separators, and items.

Information related to the ItemCreated event is passed via a DataListItemEventArgs object to the method assigned to handle the event. The following DataListItemEventArgs property provides information specific to this event.

Property	Description
Item	Gets the DataListItem associated with the event.

The following example illustrates a way to handle the ItemCreated event of a DataList. In this case, the sample simply retrieves and displays either the item type or data values of each DataListItem, in the order in which the items are created.

The below snippet shows how to attach a handler for the event.

<asp:datalist id = "myDataList" runat = "server" onItemCreated = "showItem" ... >

The below shows how the handler method is defined.

void showItem ( Object src, DataListItemEventArgs e ) {
   if ( e.Item.ItemType == ListItemType.Item ||
         e.Item.ItemType == ListItemType.AlternatingItem ) {
      object [ ] dataitems = ( ( DataRowView ) e.Item.DataItem ).Row.ItemArray;
      items.Text += "<br>" + dataitems [ 0 ] + " " + dataitems [ 1 ] + ", " + dataitems [ 2 ];
   }
   else {
      items.Text += "<br>" + e.Item.ItemType.ToString ( );
   }
}

 Show me 

DataList Members   ItemDataBound   DataListItemEventHandler

Books and more ...

Custom Search

Suggested Reading

Need a break ?