Home Library Learn Downloads Support Community
Sign in | United States - English | |
0 out of 1 rated this helpful - Rate this topic

Page.Theme Property

.NET Framework 4

Gets or sets the name of the page theme.

Namespace:  System.Web.UI
Assembly:  System.Web (in System.Web.dll)
C#
C++
F#
VB
Copy 
[BrowsableAttribute(false)]
public virtual string Theme { get; set; }
ASP.NET
Copy 
<asp:Page Theme="String" />

Property Value

Type: System.String
The name of the page theme.
Exception Condition
InvalidOperationException

An attempt was made to set Theme after the PreInit event has occurred.
ArgumentException

Theme is set to an invalid theme name.

The Theme property sets the name of the theme used for the page. If you want the settings on the page to take precedence over the settings in the theme, use the StyleSheetTheme property. For more information, see ASP.NET Themes and Skins.

The Theme property must be set prior to the PreInit event; setting the Theme property after the PreInit event will cause an InvalidOperationException exception.

The specified theme must exist as either an application or a global theme. If the theme does not exist, an HttpException exception is thrown.

The following code example sets the Theme property to a name passed in the query string.

C#
VB
Copy 

void Page_PreInit(object sender, EventArgs e)
{
  // Get the theme name from a QueryString variable
  string ThemeName;
  ThemeName = Request.QueryString["thename"];
  if (ThemeName != null)
  {
    Page.Theme = ThemeName;
  }
}

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ
If&nbsp;you&nbsp;use&nbsp;the&nbsp;Page.Theme&nbsp;property,&nbsp;the&nbsp;css&nbsp;files&nbsp;will
If&nbsp;you&nbsp;use&nbsp;the&nbsp;Page.Theme&nbsp;property,&nbsp;the&nbsp;css&nbsp;files&nbsp;will Now my edit count should be 23
History
Theme setting does NOT apply CSS style sheets to design view in Visual Studio
If you use the Page.Theme property, the css files will not be applied to the Design view which makes it difficult to make any use of the Design view in Visual Studio.  Below is an example of the Theme setting in the Web.config file which applies the theme to the entire website (VS2010):
<pages theme="Default" controlRenderingCompatibilityVersion="4.0" clientIDMode="Static">

On the other hand, Page.StyleSheetTheme does apply the css files that you have located in the App_Themes/<Theme Name>path to the "Design" view.  This is really useful because you can actually see a close representation of what your actual website will look like when designing the presentation with css in Visual Studio.

In the Web.config the following is an example of setting your theme using StyleSheetTheme which applies the theme to the entire website (VS2010):
<pages styleSheetTheme="Default" controlRenderingCompatibilityVersion="4.0" clientIDMode="Static">
History