ITemplate.InstantiateIn Method (Control)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

When implemented by a class, defines the Control object that child controls and templates belong to. These child controls are in turn defined within an inline template.

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

void InstantiateIn(
	Control container


Type: System.Web.UI.Control

The Control object to contain the instances of controls from the inline template.

When developing templated server controls, you do not need to implement this method; the .NET Framework provides the implementation for you.

// Override the ITemplate.InstantiateIn method to ensure 
// that the templates are created in a Literal control and
// that the Literal object's DataBinding event is associated
// with the BindData method.
public void InstantiateIn(Control container)
    Literal l = new Literal();
    l.DataBinding += new EventHandler(this.BindData);
// Create a public method that will handle the
// DataBinding event called in the InstantiateIn method.
public void BindData(object sender, EventArgs e)
    Literal l = (Literal) sender;
    DataGridItem container = (DataGridItem) l.NamingContainer;
    l.Text = ((DataRowView) container.DataItem)[column].ToString();


.NET Framework
Available since 1.1
Return to top