Edit User Control References dialog box

Use this dialog box to specify assembly, class, and URL information for a user control.

Windows section

Field/Option Description
Assembly Name This field specifies the name of the Windows DLL assembly file to use for the user control.

To browse to and select the DLL assembly file, click the eliipsis (...) button.

Note: This assembly must contain a class that implements a Windows (WinForms) user control. The assembly must be available to be loaded by the smart client at run-time, so it must be added to any Click-Once deployment packages or included with any other installation packages.

See About user control components.

Class Override By default, looks for the first class in an assembly that inherits from Mongoose.WinStudio.Runtime.WSUserControlBase (from WSXRuntime.dll). If an assembly contains more than one of these classes, specify the full namespace and class name in this field.
Use Web Control When this option is selected,the Web section settings are used for the user control. If this option is selected, the Windows section settings are disabled. Use this option, in conjunction with the Control URL field, to allow the user control to operate in both the smart client and the web client.

When this option is cleared, the user control uses the Windows section settings for the Windows assembly and the Web section Control URL setting for the web assembly, if any is specified.

Web section

Field/Option Description
Assembly Name This field specifies the name of the web assembly file to use for the user control.

To browse to and select the web assembly file, click the eliipsis (...) button.

The web assembly contains a class derived from the WSUserControlBase class or implementing the IWinStudioUserControl interface, and which implements the server-side communications between the Windows client runtime and your code.

The web assembly must be deployed on the Web Server. The web content can be deployed anywhere.

This assembly can also be imported as an assembly in the Web User Control Assets dialog box.

Class Override By default, looks for the first class in an assembly that inherits from Mongoose.WinStudio.Runtime.WSUserControlBase (from MGWebEngine.dll). If an assembly contains more than one of these classes, specify the full namespace and class name in this field.
Control URL This field specifies the URL of the user control, for example, http://server/Test.aspx If Relative URL is selected, then only specify the file name (and any additional path information) from the base URL, for example Test.aspx.

If the Web User Control Asset option is selected, this must be one of the HTML pages listed in the Control URL drop-down list.

Relative URL / Absolute URL / Web User Control Asset Use these options to specify whether the user control reference is an absolute URL, relative to the base URL, or a web user control asset.

If you select Relative URL, the actual URL() keyword has as part of its contents the BASEURL() substitution keyword, which is resolved at runtime.

If Web User Control Asset is selected, it indicates that the page is from forms metadata for user controls, which is maintained using the Edit Web User Control Assets dialog box.

Note: Web User Control Assets cannot be modified in a multi-tenant cloud environment.