ListView::ItemDataBound Event

.NET Framework (current version)

Occurs when a data item is bound to data in a ListView control.

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

Syntax

public:
event EventHandler<ListViewItemEventArgs^>^ ItemDataBound {
	void add(EventHandler<ListViewItemEventArgs^>^ value);
	void remove(EventHandler<ListViewItemEventArgs^>^ value);
}

Before the ListView control can be rendered, each item in the control must be bound to a record in the data source. The ItemDataBound event is raised when a data item is bound to data in the ListView control. (Data items are represented by ListViewDataItem objects.) This enables you to perform a custom routine whenever this event occurs, such as modifying the values of the data that is bound to the item.

A ListViewItemEventArgs object is passed to the event handler, which enables you to access the properties of the item that is being bound. To access a specific control in the item, use the FindControl method of the ListViewItem object that is contained in the Item property of the ListViewItemEventArgs object. You can determine which item type (data item, insert item, empty item) is being bound by using the ItemType property.

For more information about how to handle events, see NIB: Consuming Events.