Skip to main content
Email Password   helpLost your password?

Introduction

Master pages are a very cool feature in ASP.NET 2.0. They allow you to easily create a consistent look and feel throughout your website. They also provide an easy way to set/change the master pages at runtime. This is achieved by setting the MasterPageFile property of a page in the PreInit event. This, however, requires that the master pages have ContentPlaceHolders which the Content controls on the page reference through the ContentPlaceHolderID property. This article focuses on creating ContentPlaceHolders, Contents and linking them together programmatically.

Background

When I first used ASP.NET 2.0, one of the first features I used were master pages. I soon learned how to switch between such at runtime. Some time later, I was working on a small project, where the goal was to create as many things dynamically as possible (kind of a web application framework). I had a thought about using master pages that are stored in a DB (as metadata) and then later building them dynamically. I soon found out that this task is not as easy as it looks. It requires more than just the knowledge of how to create controls through code. I did some research on how to properly do this and I wanted to share this technique, hence this article was born.

Using the Code

The sample provided contains two pages and a master page. Its only purpose is to demonstrate how things are done. On the start page (Default.aspx), you are to enter a number, press a button and let the magic begin. Despite the visually not very attractive result on the next page (only some text can be seen), the magic still does happen in the background. Let's see what happens. For this, you should have some knowledge about the ASP.NET page lifecycle.

The most important step is to create the content on the page. You will be surprised to find that no creation of Content classes is necessary. Instead you should use the AddContentTemplate method of the Page class. Chances are you never heard of this method, it is because it has the [EditorBrowsable(EditorBrowsableState.Never)] attribute applied and thus isn't visible for IntelliSense. MSDN has some information about it, you can read it here. You need two parameters, the first being the name of the ContentPlaceHolder it will be linked to (you can only set the ContentPlaceHolderID attribute in the markup), the other an ITemplate. If you have never worked with templated controls, you should find this a bit complicated, but it really isn't. However explaining this still goes beyond the reach of this article. In this example, all the content is the same, but that's not obligatory, then again easier to implement and satisfactory for demonstration purposes.

protected void Page_PreInit(object sender, EventArgs e)
{
    //...same check as in the constructor of the Master Page 
    for (int i = 1; i < num + 1; i++)
        base.AddContentTemplate("ContentPlaceHolder" + i.ToString(),
            new CompiledTemplateBuilder(new BuildTemplateMethod(this.Build)));
}

Using constructors in ASP.NET is a very uncommon scenario, but in this case there's no other place to put the code needed, because the master page's Init event is already too late and there's no PreInit event. You just need to add the names of the ContentPlaceHolder controls to be created later to the ContentPlaceHolders collection of the Master class. Note that you must use the names in lowercase.

public MasterPage()
{
   object cphnum = HttpContext.Current.Session["cphnum"];
   if (cphnum == null || !(cphnum is int))
      return;
   num = (int)cphnum;
   for (int i = 1; i < num + 1; i++)
      base.ContentPlaceHolders.Add("contentplaceholder" + i.ToString()); 
}

Finally you should instantiate the ContentPlaceHolders and add them to the control hierarchy of the page. This is also achieved in a for loop, so that the required number of controls gets created. For this purpose, you must use the ContentTemplates collection the master pages base, which as of type is an ITemplate. 

protected void Page_Init(object sender, EventArgs e)
{
    //...
    for (int i = 1; i < num + 1; i++)
    {
    ContentPlaceHolder cph = new ContentPlaceHolder();
    cph.ID = "ContentPlaceHolder" + i.ToString();
    PlaceHolder1.Controls.Add(cph);
    ((ITemplate)base.ContentTemplates["ContentPlaceHolder" +
        i.ToString()]).InstantiateIn(cph);
    }
}

Now that you know the basics, you can easily extend the sample to be more useful than its current form.

History

You must Sign In to use this message board.
 
 
Per page   
 FirstPrevNext
GeneralInstantiateIn causes CreateChildControls to happen at inopportune times Pin
nbarger		19:49 19 Nov '08  
GeneralHow to fill a contentPlaceholder in a template ? Pin
lesta		6:06 8 Nov '07  
GeneralRe: How to fill a contentPlaceholder in a template ? Pin
szukuro		22:37 11 Nov '07  
QuestionOnly 1 Placeholder allowed? Pin
Elroy Skimms		4:38 19 Sep '07  
AnswerRe: Only 1 Placeholder allowed? Pin
szukuro		13:12 24 Sep '07  
GeneralRe: Only 1 Placeholder allowed? Pin
Elroy Skimms		15:41 24 Sep '07  
Generalerror in content page Pin
veerbala		3:55 18 Apr '07  
GeneralRe: error in content page Pin
szukuro		6:15 18 Apr '07  
GeneralRe: error in content page Pin
veerbala		6:46 18 Apr '07  
GeneralRe: error in content page Pin
veerbala		7:36 18 Apr '07  
QuestionHow to write html code in a ContentPlaceHolder in Master page Pin
gorkemdur		5:05 17 Apr '07  
AnswerRe: How to write html code in a ContentPlaceHolder in Master page Pin
szukuro		22:15 17 Apr '07  
GeneralRe: How to write html code in a ContentPlaceHolder in Master page Pin
gorkemdur		4:18 18 Apr '07  
QuestionIs there a VB version? Pin
reg2006		16:04 15 Apr '07  
AnswerRe: Is there a VB version? Pin
szukuro		1:04 16 Apr '07  
GeneralRe: Is there a VB version? Pin
reg2006		17:25 16 Apr '07  
GeneralDynamically filling placeholders Pin
DaveWarren		1:44 12 Apr '07  
GeneralRe: Dynamically filling placeholders Pin
szukuro		9:09 12 Apr '07  
GeneralRe: Dynamically filling placeholders Pin
DaveWarren		10:11 12 Apr '07  
GeneralRe: Dynamically filling placeholders Pin
szukuro		13:01 12 Apr '07  
GeneralRe: Dynamically filling placeholders Pin
DaveWarren		2:50 13 Apr '07  
GeneralDynamic Masterpage Content Pin
Paul Molloy		7:02 2 Apr '07  
GeneralRe: Dynamic Masterpage Content Pin
szukuro		12:42 2 Apr '07  
GeneralRe: Dynamic Masterpage Content Pin
Paul Molloy		0:39 3 Apr '07  
QuestionLate bound master pages Pin
aprenot		9:47 13 Feb '07  
Last Visit: 7:59 22 Nov '09     Last Update: 7:59 22 Nov '09 12 Next »


Last Updated 3 Nov 2009 | Advertise | Privacy | Terms of Use | Copyright © CodeProject, 1999-2009