DataRepeater.ItemTemplate Property


Gets a template that represents the DataRepeaterItem for a DataRepeater control.

Namespace:   Microsoft.VisualBasic.PowerPacks
Assembly:  Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)

member ItemTemplate : DataRepeaterItem with get

Property Value

Type: Microsoft.VisualBasic.PowerPacks.DataRepeaterItem

An object that determines the layout and appearance of items in the DataRepeater control.

Use the ItemTemplate property to set properties that determine the run time appearance of all items in a DataRepeater control. In effect, you are actually setting properties of the DataRepeaterItem objects that will be created at run time. The items that you see in the DataRepeater at run time are copied from this object as they are scrolled into view.

At design time, when you select the section of the DataRepeater that contains the controls, the Properties window contains properties for the ItemTemplate. For example, setting the BackColor property of the ItemTemplate to Red causes all the items in the DataRepeater to be displayed with a red background.

At run time, if you change the properties of the ItemTemplate, you must call the BeginResetItemTemplate method before setting the properties, and then call the EndResetItemTemplate method to commit the changes.

The ItemTemplate property is also used to access the controls in the DataRepeaterItem at run time. For example, to retrieve the BackColor of a TextBox named IDTextBox, you would use the following code:

No code example is currently available or this language may not be supported.

Some common customizations for the DataRepeater control include displaying the rows in alternating colors and changing the color of a field based on a condition. The following example shows how to perform these customizations. This example assumes that you have a DataRepeater control that is bound to the Products table in the Northwind database.

No code example is currently available or this language may not be supported.
Return to top