Control.Page Property (System.Web.UI)

Microsoft Developer Network

Page Property

.NET Framework Class Library

Control..::.Page Property

Gets a reference to the Page instance that contains the server control.

Namespace: System.Web.UI
Assembly: System.Web (in System.Web.dll)

Syntax

Visual Basic (Declaration)

<BindableAttribute(False)> _
<BrowsableAttribute(False)> _
Public Overridable Property Page As Page

Visual Basic (Usage)

Dim instance As Control
Dim value As Page

value = instance.Page

instance.Page = value

[BindableAttribute(false)]
[BrowsableAttribute(false)]
public virtual Page Page { get; set; }

Visual C++

[BindableAttribute(false)]
[BrowsableAttribute(false)]
public:
virtual property Page^ Page {
    Page^ get ();
    void set (Page^ value);
}

JScript

public function get Page () : Page
public function set Page (value : Page)

Property Value

Type: System.Web.UI..::.Page
The Page instance that contains the server control.

Exceptions

Exception	Condition
InvalidOperationException	The control is a Substitution control.

Remarks

This property's value reflects the name of the .aspx file that contains the server control.

Examples

The following example overrides the Control..::.Render method. It uses the Page property to access the Page..::.IsPostBack property and determine whether the page that contains this control has just been loaded for the first time or is the result of a postback.

Visual Basic

Protected Overrides Sub Render(output As HtmlTextWriter)
   output.Write("Welcome to Control Development!<br>")

   ' Test if the page is loaded for the first time
   If Not Page.IsPostBack Then
      output.Write("Page has just been loaded")
   Else
      output.Write("Postback has occured")
   End If
End Sub

      protected override void Render(HtmlTextWriter output) 
       {
         output.Write("Welcome to Control Development!<br>");

            // Test if the page is loaded for the first time
            if (!Page.IsPostBack)
                output.Write("Page has just been loaded");
           else
                output.Write("Postback has occured");
       }

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

Reference

Control Class

Control Members

System.Web.UI Namespace

Page