XhtmlMobileTextWriter::AddOnEnterForwardSetVar Method (String^)
Adds a provided variable name to a list of variables to be embedded in pages for WML devices. This API is obsolete. For information about how to develop ASP.NET mobile applications, see the www.asp.net/mobile Web site.
Assembly: System.Web.Mobile (in System.Web.Mobile.dll)
Parameters
- var
-
Type:
System::String^
The name of a variable to be embedded in a page.
Certain WML devices require a <wml:onevent> element to provide information for postback.
WML devices provide limited functionality for navigation and postback, and require WML commands and variables to be written to the page.
This method is used primarily by developers of custom mobile page and control adapters.
When rendering the page, the following <wml:onevent> structure might be included in the page's markup:
<wml:onevent type="onenterforward">
<wml:refresh>
<wmlsetvar name="buttonSaveClicked" />
<wmlsetvar name="nextPage" value="3" />
</wml:refresh>
</wml:onevent>
Depending on the user's actions, the values might be modified by scripts on the page to return the following structure on postback:
<wml:onevent type="onenterforward">
<wml:refresh>
<wmlsetvar name="buttonSaveClicked" value="true" />
<wmlsetvar name="nextPage" value="9" />
</wml:refresh>
</wml:onevent>
Available since 2.0