To have the CE Web Form Renderer available in the toolbox in Visual Studio it must first be added. To do so, perform the following:
Open the toolbox for Web Forms from the View menu in Visual Studio.
With a form open in the Visual Studio designer window, right-click anywhere in the toolbox and select Add\Remove items from the context menu to display the Customize Toolbox dialog box.
Browse for the CEWebFormRenderer.dll which is located in the Component Enabler\ASP.NET Generator\Bin folder.
Click Open, then click OK to add it to the Toolbox.
The CE Web Form Renderer is a control that can be dragged and dropped onto a System.Web.UI.Page. It is capable of managing an entire session with the runtime host, navigating from ispec to ispec, showing the browser user each form, with no intervention required by the programmer.
The programmer is able to intercept certain events raised by the CE Web Form Renderer, and take control of the session.
It is possible to have multiple CE Web Form Renderer controls on a web page, each with its own independent session to the host.
Usage Restrictions
The CE WinForm Renderer is only available for use in .NET languages utilizing the System.Web.UI.Page namespace.
The form rendering is achieved using the generated ASP.NET Web User Controls for each ispec, hence you must generate using the ASP.NET Generator, even if you do not intend to use the default web page that is supplied.
While the forms are generated using the C# language, the CE Web Form Renderer can be utilized in any of the other .NET client languages. For example, you can write you client in VB.NET, J# or managed C++ ,and C#.
Error Handling
The CE Web Form Renderer is capable of displaying error messages to the browser user, however this is only done after a status event has been raised, so that the hosting page might handle the error situation itself, or allow the CE Web Form Renderer to handle the error.
The AutoConnect method sets the Response code if the connection is not successful. The Response code contains a CEWindowsAPI.ResponseCode to indicate what error occurred.
Refer to the CEWindowsAPI.ResponseCodes class for the error codes that might be returned. This can be found in the Component Enabler Class Reference.chm help file which is installed in the Doc folder of the Component Enabler installation.
Other errors encountered in the displaying and processing of forms are returned via the status event.