The System.Web.UI.Adapters.PageAdapter class is an abstract class that adapts a Web page for a specific class of browsers, defined by the markup language that the browser uses (for example, HTML or XHTML). Much of the adaptability in rendering behavior can be encapsulated in the specialized text writer classes that derive from the System.Web.UI.HtmlTextWriter class, so it is not always necessary to provide a page adapter.

Most members of derived page adapters are called from the System.Web.UI.Page class or from control adapters. First, the System.Web.UI.Page class or control adapters detect the presence of the derived page adapter, and then call the member, or provide the functionality if the page adapter is not present.

The members of the System.Web.UI.Adapters.PageAdapter class provide the following functionality:

• The PageAdapter.CacheVaryByHeaders and PageAdapter.CacheVaryByParams properties define additional HTTP headers and HTTP GET and POST parameters that can be used to vary caching. They are called during cache initialization from the System.Web.UI.Page class.

• The PageAdapter.GetStatePersister method returns an object that can be used to persist the combined view and control states of the page. It is referenced from the System.Web.UI.Page.PageStatePersister property if a derived page adapter is present.

• The PageAdapter.GetPostBackFormReference(string) method provides a DHTML code fragment that can be used to reference forms in scripts.

• The PageAdapter.DeterminePostBackMode method returns a collection of the postback variables if the page is in postback. It is called by the .NET Framework instead of the System.Web.UI.Page.DeterminePostBackMode method if a derived page adapter is present.

• The erload:System.Web.UI.Adapters.PageAdapter.RenderBeginHyperlink and PageAdapter.RenderEndHyperlink(System.Web.UI.HtmlTextWriter) methods are used by control adapters to render hyperlinks if a derived page adapter is present.

• The erload:System.Web.UI.Adapters.PageAdapter.RenderPostBackEvent method renders a hyperlink or postback client tag that can submit the form.

• The PageAdapter.RegisterRadioButton(System.Web.UI.WebControls.RadioButton) and PageAdapter.GetRadioButtonsByGroup(string) methods are used by radio button control adapters to reference the other System.Web.UI.WebControls.RadioButton controls in a radio button group.

• The PageAdapter.ClientState property provides access to the combined control and view states of the System.Web.UI.Page object through the internal ClientState property of the System.Web.UI.Page class.

• The PageAdapter.TransformText(string) method is used by control adapters to perform device-specific text transformation.

Namespace: System.Web.UI.Adapters
Assembly: System.Web (in System.Web.dll)
Assembly Versions: 2.0.0.0
Since: .NET 2.0