Page

Pagedisposable

System.Web.UI (system.web.dll)class

All Web Forms you create for an ASP.NET application derive implicitly or explicitly from Page. This class, which is a special subclass of Control, adds additional page-specific functionality. For example, rather than simply providing the Control.Context property, the Page class provides the traditional built-in objects through references like Response, Request, and Application. The Page class also provides properties that allow you to use tracing (Trace and TraceEnabled) and access all the validation controls and information about whether their validation was successful (Validators and IsValid).

Another useful property is IsPostBack, which you can test in the Load event. Typically, you will skip control initialization if this property returns True, indicating that the page has already been displayed and the control values will be persisted in view state. You can also set AspCompatMode to True so the Page will be executed on a single-threaded apartment (STA) thread. This setting allows the page to call other STA components, such as those you may have developed with Visual Basic 6 (although it can hamper performance significantly).

Most Page methods are used by the ASP.NET framework and will never be used in your code. One exception is MapPath( ), which returns the physical path on the server that corresponds to a specified virtual path (URL).

public class Page : TemplateControl, System.Web.IHttpHandler { // Public Constructors    public Page( ); // Protected Static Fields    protected const string postEventArgumentID;                   // =_ _EVENTARGUMENT    protected const string postEventSourceID;        // =_ _EVENTTARGET // Public Instance Properties    public HttpApplicationState Application{get; }    public Cache Cache{get; }    public string ClientTarget{set; get; }    public override bool EnableViewState{set; get; }              // overrides Control    public string ErrorPage{set; get; }    public override string ID{set; get; }            // overrides Control    public bool IsPostBack{get; }    public bool IsReusable{get; }                    // implements System.Web.IHttpHandler    public bool IsValid{get; }    public HttpRequest Request{get; }    public HttpResponse Response{get; }    public HttpServerUtility Server{get; }    public virtual HttpSessionState Session{get; }    public bool SmartNavigation{set; get; }    public TraceContext Trace{get; }    public IPrincipal User{get; }    public ValidatorCollection Validators{get; }    public string ViewStateUserKey{set; get; }    public override bool Visible{set; get; }         // overrides Control // Protected Instance Properties    protected bool AspCompatMode{set; }    protected bool Buffer{set; }    protected int CodePage{set; }    protected string ContentType{set; }    protected override HttpContext Context{get; }                 // overrides Control    protected string Culture{set; }    protected bool EnableViewStateMac{set; get; }    protected ArrayList FileDependencies{set; }    protected int LCID{set; }    protected string ResponseEncoding{set; }    protected bool TraceEnabled{set; }    protected TraceMode TraceModeValue{set; }    protected int TransactionMode{set; }    protected string UICulture{set; } // Public Instance Methods    public void DesignerInitialize( );    public string GetPostBackClientEvent(Control control, string argument);    public string GetPostBackClientHyperlink(Control control, string argument);    public string GetPostBackEventReference(Control control);    public string GetPostBackEventReference(Control control, string argument);    public virtual int GetTypeHashCode( );    public bool IsClientScriptBlockRegistered(string key);    public bool IsStartupScriptRegistered(string key);    public string MapPath(string virtualPath);    public void ProcessRequest(System.Web.HttpContext context);  // implements System.Web.IHttpHandler    public void RegisterArrayDeclaration(string arrayName, string arrayValue);    public virtual void RegisterClientScriptBlock(string key, string script);    public virtual void RegisterHiddenField(string hiddenFieldName, string hiddenFieldInitialValue);    public void RegisterOnSubmitStatement(string key, string script);    public void RegisterRequiresPostBack(Control control);    public virtual void RegisterRequiresRaiseEvent(IPostBackEventHandler control);    public virtual void RegisterStartupScript(string key, string script);    public void RegisterViewStateHandler( );    public virtual void Validate( );    public virtual void VerifyRenderingInServerForm(Control control); // Protected Instance Methods    protected IAsyncResult AspCompatBeginProcessRequest(System.Web.HttpContext context,          AsyncCallback cb, object extraData);    protected void AspCompatEndProcessRequest(IAsyncResult result);    protected virtual HtmlTextWriter CreateHtmlTextWriter(System.IO.TextWriter tw);    protected virtual NameValueCollection DeterminePostBackMode( );    protected virtual void InitOutputCache(int duration, string varyByHeader, string varyByCustom,          OutputCacheLocation location, string varyByParam);    protected virtual object LoadPageStateFromPersistenceMedium( );    protected virtual void RaisePostBackEvent(IPostBackEventHandler sourceControl, string eventArgument);    protected virtual void SavePageStateToPersistenceMedium(object viewState); }

Hierarchy

System.Object Control(System.ComponentModel.IComponent, System.IDisposable, IParserAccessor, IDataBindingsAccessor) TemplateControl(INamingContainer) Page(System.Web.IHttpHandler)

Subclasses

System.Web.UI.MobileControls.MobilePage

Returned By

Control.Page

Passed To

Control.Page, UserControl.InitializeAsUserControl( )



ASP. NET in a Nutshell
ASP.NET in a Nutshell, Second Edition
ISBN: 0596005202
EAN: 2147483647
Year: 2003
Pages: 873

flylib.com © 2008-2017.
If you may any questions please contact us: flylib@qtcs.net