MobileControl::ResolveFormReference Method (String^)

.NET Framework (current version)

Note
The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Returns the form object referenced by the name parameter. This API is obsolete. For information about how to develop ASP.NET mobile applications, see the www.asp.net/mobile Web site.

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

Syntax

C++

public:
Form^ ResolveFormReference(
	String^ formID
)

Parameters

formID: Type: System::String^
Form object

Return Value

Type: System.Web.UI.MobileControls::Form^

The form referenced by the name parameter.

Exceptions

Exception	Condition
Exception	formID does not refer to an existing Form.

If you have a link of the format "#form1" in a control contained in a user control, this method looks for a form with id=form1 in the user control. If not found, it goes up the chain of any nested user controls, and then searches for the form on the page.

Note
Scoping rules walk up, not down, the chain. If you want to browse to a form that is contained in a user control, you must use the ":" syntax used by FindControl method to refer to the form.

Version Information

.NET Framework
Available since 1.1