Pages and Controls

 

Applies To: Windows Server 2012 R2, Windows Server 2012

Use the Pages and Controls feature page to configure the settings of ASP.NET pages and controls. These settings control the behavior of ASP.NET pages, set how ASP.NET pages and controls are compiled on the server, define the namespaces that are included for each page, and define the session state and validation services settings.

Use the Display list to select one of the following options that specifies how the settings are displayed: Friendly Names, Configuration Names, or Both Names.

Related scenarios

In this document

UI Elements for Pages and Controls

The following tables describe the UI elements that are available on the feature page and in the Actions pane.

Feature Page Elements

Element Name

Description

Buffer

Sets a value (true or false) that specifies whether .aspx pages and .ascx controls use response buffering. The default setting is True.

Master Page File

Specifies the master page path relative to the local configuration file.

Style Sheet Theme

Specifies the name of the "named theme" folder that is used to apply the theme before control declarations. This option differs from the theme attribute, which defines the theme to apply after the control declarations.

Theme

Specifies the name of the theme that is used for the pages that are in the scope of the configuration file. The specified theme must exist as either an application or a global theme. If the theme does not exist, an HttpException exception is thrown.

Enable Authenticated View State

Sets a value (true or false) that specifies whether ASP.NET should run a message authentication code (MAC) on the page's view state when the page is posted back from the client. The default setting is True.

Enable View State

Sets a value (true or false) that indicates whether view state is enabled, disabled, or read only. The default setting is True.

Maximum Page State Field Length

Sets the maximum number of characters that a single view-state field can contain.

Base Type for Pages

Specifies the base type to use when the pages are stand-alone only. This option is overridden by the inherits attribute in a stand-alone file.

Base Type for User Controls

Specifies a code-behind class that user controls inherit by default.

Compilation Mode

Specifies whether an ASP.NET page or control should be compiled at run time.

Namespaces

Defines a collection of import directives to use during assembly precompilation.

Enable Session State

Sets a value (true or false) that specifies whether the session state is enabled, disabled, or read-only. The default setting is True.

Validate Request

Sets a value (true or false) that determines whether ASP.NET examines input from the browser for dangerous values. The default setting is True.

Actions Pane Elements

Element Name

Description

Apply

Saves the changes that you have made on the feature page.

Cancel

Cancels the changes that you have made on the feature page.

Register Controls

Opens the Controls feature page from which you can add and edit custom controls.

Controls Page

Use the Controls feature page to manage a list of user controls and custom controls.

Note

User controls are not available at the server level in IIS Manager.

Sort the list by clicking one of the feature page column headings or select a value from the Group by drop-down list to group similar items.

Feature Page Elements

Element Name

Description

Tag

For custom controls, displays the tag prefix assigned to the control. For user controls, displays the tag prefix and tag name for the user control.

Source or Assembly

Displays the user control path or assembly name in which the custom control type is defined.

Entry Type

Displays whether the item is local or inherited. Local items are read from the current configuration file, and inherited items are read from a parent configuration file.

Actions Pane Elements

Element Name

Description

Add Custom Control

Opens the Add Custom Control dialog box in which you can add a custom control.

Add User Control

Opens the Add User Control dialog box in which you can add a user control. This action is not available at the server level.

Edit

When a custom control is selected, this action opens the Edit Custom Control dialog box in which you can edit the custom control.

When a user control is selected, this action opens the Edit User Control dialog box in which you can edit the user control. You cannot edit a user control at the server level.

Remove

Removes the item that is selected from the list on the feature page.

Add or Edit Custom Control and Add or Edit User Control Dialog Boxes

Use the Add Custom Control and Edit Custom Control dialog boxes to specify or edit the tag prefix/namespace mapping for a custom control that will be used in multiple pages in an application. Use the Add User Control and Edit User Control dialog boxes to configure user controls, which are containers into which you can put markup and Web server controls.

For more information about user and custom controls, see ASP.NET User Controls Overview.

Element Name

Description

Tag prefix

Sets the tag prefix assigned to the control, for example, <aspSample: …>

Namespace

Defines the namespace to which the custom control belongs. This setting is the same namespace that was specified in the application code.

This box is available only for custom controls.

Assembly

Sets the assembly name in which the custom control type is defined.

This box is available only for custom controls.

Tag Name

Specifies the tag name of the user control.

This box is available only for user controls.

User Control (.ascx) Path

Specifies the file path of the user control.

This box is available only for user controls.