ASP.NET Tip: Selecting a Master Page at Runtime | CodeGuru

ASP.NET Tip: Selecting a Master Page at Runtime

Master pages, introduced with ASP.NET 2.0, provide developers an easy way to create a shared layout for a site or portion of a site without having to work around Visual Studio .NET. While many sites will have a master page specified in each page by default, you can also design your site to select a […]

Written By
CodeGuru Staff
CodeGuru Staff
Sep 13, 2006
2 minute read
CodeGuru content and product recommendations are editorially independent. We may make money when you click on links to our partners. Learn More

Master pages, introduced with ASP.NET 2.0, provide developers an easy way to create a shared layout for a site or portion of a site without having to work around Visual Studio .NET. While many sites will have a master page specified in each page by default, you can also design your site to select a master page dynamically. For example, an application I’ve created contains two master pages. Which one the user sees depends on which hostname he or she uses to visit the site. I do this so that the graphics and text are appropriate for the domain, but I have a single Web site servicing both domains behind the scenes.

The trick to selecting a master page at runtime is to add code into the OnPreInit event handler of your Web page. This is the point at which you can select the master page to be used for the particular Web page. For instance, you might have code that looks like this:

protected override void OnPreInit(EventArgs e)
{
   base.OnPreInit(e);
   if (Request.Url.Host.Contains("test.com"))
      base.MasterPageFile = Server.MapPath("test.com.master");
   else
      base.MasterPageFile = Server.MapPath("test2.com.master");
}

The MasterPageFile property requires a pathname and not a URL reference. However, you can always use Server.MapPath to convert your URL into an actual filename.

This feature works quite well for the content management system I’ve built. Use it to allow a page to choose a different look on the fly, based on whatever criteria you choose.

About the Author

Eric Smith is the owner of Northstar Computer Systems, a Web-hosting company based in Indianapolis, Indiana. He is also a MCT and MCSD who has been developing with .NET since 2001. In addition, he has written or contributed to 12 books covering .NET, ASP, and Visual Basic. Send him your questions and feedback via e-mail at questions@techniquescentral.com.

CodeGuru Logo

CodeGuru covers topics related to Microsoft-related software development, mobile development, database management, and web application programming. In addition to tutorials and how-tos that teach programmers how to code in Microsoft-related languages and frameworks like C# and .Net, we also publish articles on software development tools, the latest in developer news, and advice for project managers. Cloud services such as Microsoft Azure and database options including SQL Server and MSSQL are also frequently covered.

Property of TechnologyAdvice. © 2026 TechnologyAdvice. All Rights Reserved

Advertiser Disclosure: Some of the products that appear on this site are from companies from which TechnologyAdvice receives compensation. This compensation may impact how and where products appear on this site including, for example, the order in which they appear. TechnologyAdvice does not include all companies or all types of products available in the marketplace.