Background
ASP.Net Page directives provide the major role of processing web pages. This article explains what they are and when to use them. This article begins with the basics so beginners can also understand.
What directives are
Directives define the page configuration and properties that decide how the page will be processed. If the directives are not defined at the page level then the setting is inherited from web.config or machine.config file.
The following are the directive in ASP.Net.
Assembly
The Assembly directive is used to register the assembly reference The following is the syntax of an assembly directive to be defined at the page level. Assembly directives have the following attributes:
For example:
- <%@ Assembly Name="assemblyname" Src="SourceofAssembly.dll"%>
Implements
The Implements directive is used to specify that the page implements interfaces, it has the following attribute:
For example:
- <%@ Implements Interface="InterfaceName"%>
Import
The Import directive imports a namespace into a page or user control explicitly, it has the following attribute:
For example:
- <%@ Import CodeFile="~/Default.aspx.cs" ClassName="" Inherits="" Language="C#"%>
MasterType
The MasterType directive creates a strongly typed reference to the ASP.NET master page when the master page is accessed from the Master property. It has the following attributes:
- <%@MasterType TypeName="Name" VirtualPath="virtualPathofFile"%>
OutPutCache
The OutPutCache directive configures the caching of the page that defines what type of caching is used. It has the following attributes:
- Duration
- Location
- ServerAndClient
- Shared
- VaryByControl
- VaryByCustom
- VaryByHeader
- VaryByParam
- VaryByContentEncoding
- CacheProfile
- NoStore
- SqlDependency
- ProviderName
For example:
- <%@OutPutCache CacheProfile="ProFileName" Duration="defineduration" SqlDependency="definedependency" %>
Page
The Page directive is the most commonly used directives that define the entire configuration of the page.
- Async
- AsyncTimeOut
- AspCompat
- AutoEventWireup
- Buffer
- ClassName
- ClientIDMode
- ClientTarget
- CodeBehind
- CodeFile
- CodeFileBaseClass
- CodePage
- CompilationMode
- CompilerOptions
- ContentType
- Culture
- Debug
- Description
- EnableSessionState
- EnableTheming
- EnableViewState
- EnableViewStateMac
- ErrorPage
- Explicit
- Inherits
- Language
- LCID
- LinePragmas
- MaintainScrollPositionOnPostback
- MasterPageFile
- MetaDescription
- MetaKeywords
- ResponseEncoding
- SmartNavigation
- Src
- Strict
- StyleSheetTheme
- TargetSchema
- Theme
- Title
- Trace
- TraceMode
- Transaction
- UICulture
- ValidateRequest
- ViewStateEncryptionMode
- ViewStateMode
- WarningLevel
For example:
- <%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" %>
PreviousPageType
The PreviousPageType directive defines the Previous Page reference and access the properties of the child page. It has the following attributes:
For example:
- <%@PreviousPageType TypeName="TyepOfFile" VirtualPath="PathOfTheFile"%>
Reference
The Reference directive indicates that another user control, page source file or arbitrary file located at some virtual path should be dynamically compiled and linked against the current ASP.NET file such as Web page, user control, or master page in which this directive is declared. It has the following attributes:
For example:
- <%@Reference Control="UrlOfControl" Page="PageUrl" VirtualPath="VirtualpathOfFile"%>
Register
The Register directive registers the user and custom control on a page. It has the following attributes:
- Assembly
- Namespace
- Src
- TagName
- TagPrefix
For example:
- <%@Register Assembly="assemblyName" Namespace="NameSpaceFile" Src="SourceFileUrl" TagName="TagName" TagPrefix="Prefix"%>
Master
The Master directive is used for master page configuration. It has the following attributes:
- AutoEventWireup
- CodeFile
- CompilationMode
- CompilerOptions
- Debug
- Description
- EnableTheming
- EnableViewState
- Explicit
- Inherits
- Language
- LinePragmas
- MasterPageFile
- Src
- Strict
- WarningLevel
For example:
- <%@ Master Language="C#" AutoEventWireup="true" CodeFile="MasterPage.master.cs" Inherits="MasterPage" %>
Control
The Control directive is used for user control configuration. It has the following attributes:
- AutoEventWireup
- ClassName
- ClientIDMode
- CodeBehind
- CodeFile
- CodeFileBaseClass
- CompilationMode
- CompilerOptions
- Debug
- Description
- EnableTheming
- EnableViewState
- Explicit
- Inherits
- Language
- LinePragmas
- Src
- Strict
- TargetSchema
- WarningLevel
For example:
- <%@ Control Language="C#" AutoEventWireup="true" CodeFile="WebUserControl.ascx.cs" Inherits="WebUserControl" %>
From all the preceding examples, we have learned about the page directives and their importance.
Note
- For the detailed practical approach, create sample pages using the preceding directives.
Summary
For all the examples above, we have learned about the directives. I hope this article is useful for all readers. If you have a suggestion then please contact me.