Click here to Skip to main content
15,884,177 members
Articles / Web Development / ASP.NET

A Beginner's Tutorial for Understanding Templated User Controls

Rate me:
Please Sign up or sign in to vote.
5.00/5 (13 votes)
6 Jun 2012CPOL5 min read 76.9K   926   35  
Understanding templated web user controls from a beginner's perspective.
using System;
using System.Data;
using System.Configuration;
using System.Collections;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.HtmlControls;
using System.ComponentModel;

public partial class TemplateUCtrl : System.Web.UI.UserControl 
{
    //the template control specific stuff
    private ITemplate personTemplate;
 
    //the controls data specific stuff
    private PersonItem personItem = null;

    protected void Page_Init(object sender, EventArgs e)
    {
        //lets first clear the placeholders to attach then to new data
        this.phdPerson.Controls.Clear();     

        //but what if the user forgot to send the user information   
        if (Person == null)
        {  
            phdPerson.Controls.Add(new LiteralControl("Please attach the control with a person object."));         
        }
        else
        {
            //check if the templates are null we want to use simple literal
            //The user wants the default representation of the control
            if (PersonTemplate == null)
            {
                //Lets show the default representation of the control
                phdPerson.Controls.Add(new LiteralControl("<Strong>First Name: </strong>"));
                phdPerson.Controls.Add(new LiteralControl(Person.FirstName));
                phdPerson.Controls.Add(new LiteralControl("<br/>"));
                phdPerson.Controls.Add(new LiteralControl("<Strong>Last Name: </strong>"));
                phdPerson.Controls.Add(new LiteralControl(Person.LastName));
                phdPerson.Controls.Add(new LiteralControl("<br/>"));
                phdPerson.Controls.Add(new LiteralControl("<Strong>Age: </strong>"));
                phdPerson.Controls.Add(new LiteralControl(Person.Age.ToString()));
            }
            else
            {
                PersonItemContainer container = new PersonItemContainer(this.Person);
                this.PersonTemplate.InstantiateIn(container);
                phdPerson.Controls.Add(container);
            }
        }
    }

    [PersistenceMode(PersistenceMode.InnerProperty)]
    [TemplateContainer(typeof(PersonItemContainer))]
    public ITemplate PersonTemplate
    {
        get
        {
            return personTemplate;
        }
        set
        {
            personTemplate = value;
        }
    }

    public PersonItem Person
    {
        get
        {
            return personItem;
        }
        set
        {
            personItem = value;
        }
    }    
}

By viewing downloads associated with this article you agree to the Terms of Service and the article's licence.

If a file you wish to view isn't highlighted, and is a text file (not binary), please let us know and we'll add colourisation support for it.

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
Architect
India India

I Started my Programming career with C++. Later got a chance to develop Windows Form applications using C#. Currently using C#, ASP.NET & ASP.NET MVC to create Information Systems, e-commerce/e-governance Portals and Data driven websites.

My interests involves Programming, Website development and Learning/Teaching subjects related to Computer Science/Information Systems. IMO, C# is the best programming language and I love working with C# and other Microsoft Technologies.

  • Microsoft Certified Technology Specialist (MCTS): Web Applications Development with Microsoft .NET Framework 4
  • Microsoft Certified Technology Specialist (MCTS): Accessing Data with Microsoft .NET Framework 4
  • Microsoft Certified Technology Specialist (MCTS): Windows Communication Foundation Development with Microsoft .NET Framework 4

If you like my articles, please visit my website for more: www.rahulrajatsingh.com[^]

  • Microsoft MVP 2015

Comments and Discussions