You can generate JavaScript files that contain the JavaScript required to manage common DataWindow operations, and operations with DateTime, number, and string datatypes. You can distribute these files in one of three ways by selecting one of the following values for JavaScriptOption in the JavaScriptConfigurations section in the Properties window for the WebDataWindowControl:
EmbeddedinPageAtRendering The JavaScript is embedded in each Web page when it is rendered (for the HTML rendering format) or in internal JavaScript files that are generated when the page is rendered (for the XML and XHTML rendering formats). This simplifies deployment, because you do not need to specify the names and locations of external files, but it reduces performance because the JavaScript needs to be regenerated for each DataWindow.
External The JavaScript functions are deployed to the browser once per session in standalone files that are cached in the browser, improving performance and reducing network bandwidth. If you select this option, you need to generate the JavaScript files, add them to your application as resouce content, and specify the names of the files and their URL path. You must regenerate the files every time you update to a new version of DataWindow .NET to ensure that any enhancements added in the new version are incorporated in the generated JavaScript files.
WebResourceFile The JavaScript functions are deployed in files that are embedded in the WebDataWindow.dll assembly as a Web resource. With this option, JavaScript functions are deployed to the browser once per session, as with the External option, gaining the same performance advantages and the additional advantage that you do not need to generate and deploy the files.
If you select External, you need to generate the JavaScript files. To generate the JavaScript files in Visual Studio .NET, select Generate Client Management JavaScript from the pop-up menu for the WebDataWindowControl or from its Properties window and complete the dialog box. The files are saved to the URL path you specify or to the root directory for your application if no URL path is specified.
You can also generate JavaScript files for the HTML Web DataWindow in DataWindow Designer. For more information, see “Using JavaScript caching in DataWindow Designer”.
