ASP.NET.in.a.Nutshell.Second.Edition [Electronic resources]

A Form is the outermost grouping of controls in a mobile page. All mobile controls must be placed inside a form. You can add multiple forms to a page, although only one will be visible at a time. To change the currently displayed form, you can set the ActiveForm property, or you can create a Link control with a Link.NavigateUrl set to the name of the desired form (preceded by the # symbol). Forms cannot be nested (although you can nest one or more Panel controls).

The Form control supports literal text. You can also insert markup tags directly into the literal text of a Form. Supported tags include <a> (anchor), <b> (bold), <i> (italic), <br> (line break), and <p> (paragraph). These tags will be rendered in a device-independent manner, which means that a <p> could conceivably be translated into a <br> tag if required by the client device. In order to ensure compatibility across a broad range of devices, all other tags are ignored, and will never affect the control's output.

public class 
Form  : Panel, System.Web.UI.IPostBackEventHandler {
// Public Constructors
public 
Form ( );
// Public Instance Properties
public string 
Action {set; get; }
public override bool 
BreakAfter {set; get; }                   // overrides Panel
public Control 
ControlToPaginate {set; get; }
public int 
CurrentPage {set; get; }
public Panel 
Footer {get; }
public Panel 
Header {get; }
public FormMethod 
Method {set; get; }
public int 
PageCount {get; }
public PagerStyle 
PagerStyle {get; }
public Panel 
Script {get; }
public string 
Title {set; get; }
// Protected Instance Properties
protected override bool 
PaginateChildren {get; }               // overrides Panel
// Public Instance Methods
public override void 
CreateDefaultTemplatedUI (                // overrides Panelbool 
doDataBind );
public IList 
GetLinkedForms (int 
optimumPageWeight );
public virtual bool 
HasActivateHandler ( );
public virtual bool 
HasDeactivateHandler ( );
public override void 
PaginateRecursive ( );          // overrides PanelControlPager 
pager 
// Protected Instance Methods
protected override void 
LoadPrivateViewState (object 
state );                 // overrides MobileControl
protected virtual void 
OnActivate (EventArgs 
e );
protected override void 
OnDataBinding (EventArgs 
e );          // overrides MobileControl
protected virtual void 
OnDeactivate (EventArgs 
e );
protected override void 
OnInit (EventArgs 
e );                 // overrides Panel
protected virtual void 
OnPaginated (EventArgs 
e );
protected override void 
OnPreRender (EventArgs 
e );            // overrides MobileControl
protected override void 
Render (System.Web.UI.HtmlTextWriter 
writer );
// overrides MobileControl 
protected override object 
SavePrivateViewState ( );             // overrides MobileControl
// Events
public event EventHandler 
Activate ;
public event EventHandler 
Deactivate ;
public event EventHandler 
Paginated ;
}

Hierarchy

System.Object System.Web.UI.Control(System.ComponentModel.IComponent, System.IDisposable, System.Web.UI.IParserAccessor, System.Web.UI.IDataBindingsAccessor) MobileControl(System.Web.UI.IAttributeAccessor) Panel(ITemplateable) Form(System.Web.UI.IPostBackEventHandler)

Returned By

System.Web.UI.MobileControls.Adapters.HtmlFormAdapter.Control, System.Web.UI.MobileControls.Adapters.WmlFormAdapter.Control, System.Web.UI.MobileControls.Adapters.WmlMobileTextWriter.CurrentForm, MobileControl.{Form, ResolveFormReference( )}, MobilePage.{ActiveForm, GetForm( )}

Passed To

System.Web.UI.MobileControls.Adapters.HtmlPageAdapter.{GetFormUrl( ), IsFormRendered( ), RenderForm( ), RenderPostBackHeader( )}, System.Web.UI.MobileControls.Adapters.WmlMobileTextWriter.{BeginForm( ), RenderBeginForm( )}, System.Web.UI.MobileControls.Adapters.WmlPageAdapter.{IsFormRendered( ), RenderForm( )}, ControlPager.ControlPager( ), MobilePage.ActiveForm