This section describes the XML, XHTML, and HTML DataWindow object properties for the Web DataWindow that you can get or set in DataWindow Designer or in code in your Windows Forms or ASP.NET application, using the Modify or SetProperty methods.
Some properties that you can set for the DataWindow object in DataWindow Designer have equivalents that you can also be set in the Properties window for a WebDataWindowControl. If a property is set in DataWindow Designer, it is respected in DataWindow .NET. However, the properties you set in the painter are not reflected in the Properties window, which displays default values for most properties. For more information, see “Understanding how properties interact”.
For more detailed information about each property, see the DataWindow Object Reference or the online Help for the property name in DataWindow Designer. For information about how to set properties in DataWindow Designer, including shared HTML and XHTML properties, see “Setting Web generation properties for the Web DataWindow”.
Table 10-2 shows row data properties for the XML and XHTML Web DataWindow.
Property |
Properties window location |
Description |
|---|---|---|
Data.XHTML |
Read only, so not available in Properties window |
A string containing the row data content of the DataWindow object in XHTML format |
Data.XMLWeb |
Read only, so not available in Properties window |
A string containing browser-specific JavaScript that performs the XSLT transformation on the browser |
Table 10-3 lists DataWindow object properties supporting XML Web DataWindow generation. If you set the XmlConfigurations.UrlPath property in the Properties window for a WebDataWindowControl, the JSGen, XMLGen, and XSLTGen ResourceBase and PublishPath properties are ignored. For more information about the properties in the WebGeneration category, see “Setting Web generation properties for the Web DataWindow”.
Property |
Properties window location |
Allows you to |
|---|---|---|
CSSGen.property |
WebGeneration category with CSS selected as the WebDW format |
Specify the physical path to which a generated CSS style sheet is published and the URL indicating the location of the style sheet where the property variable is PublishPath or ResourceBase, as well as whether generated CSS, XSLT, and JavaScript file names are specific to a session |
JSGen.property |
JavaScriptGeneration category with XHTML selected as the JSGen format |
Specify the physical path to which generated JavaScript (that is included in the final XHTML page) is published and the URL indicating the location of the generated JavaScript where the property variable is PublishPath or ResourceBase |
XMLGen.property |
WebGeneration category with XML selected as the WebDW format |
Specify the physical path to which XML is published and the URL referenced by the JavaScript that transforms the XML to XHTML where the property variable is PublishPath or ResourceBase, as well as whether XML is generated in the XSLT transformation script for security |
XSLTGen.property |
WebGeneration category with XSLT selected as the WebDW format |
Specify the physical path to which the generated XSLT style sheet is published and the URL referenced by the JavaScript that transforms the XML to XHTML (using the generated XSLT stylesheet) where the property variable is PublishPath or ResourceBase |
XHTMLGen.Browser |
WebGeneration category with XHTML selected as the WebDW format |
Identify the browser in which XHTML generated within an XSLT style sheet is displayed |
About PublishPath and ResourceBase
PublishPath is a string that specifies the physical path of
the Web site folder to which DataWindow .NET publishes generated
CSS, JavaScript, XML, or XSLT. ResourceBase is a string that specifies
the URL of the generated file. For example, you might set CSSGen.ResourceBase
to /MyWebApp/cssfiles and CSSGen.PublishPath
to C:\Inetpub\wwwroot\MyWebApp\cssfiles,
and set similar paths for the JSGen, XMLGen, and XSLTGen properties.
There are four types of HTML properties you can set in DataWindow Designer. The first three apply to the DataWindow object itself. The last applies to bitmap, column, computed field, and text controls in the DataWindow object. Many of these properties can be overridden in the Properties window in the development environment.
Property |
Properties window location |
Allows you to |
|---|---|---|
HTMLDW (shared by all Web DataWindow formats) |
General category |
View the HTML in a browser using Design>HTML Preview. |
HTMLTable.property (HTML only) |
HTMLTable category |
Change the display characteristics of HTML tables, including border style and cell width and padding. |
HTMLGen.property (shared by all Web DataWindow formats) |
JavaScriptGeneration and WebGeneration categories with HTML/XHTML selected as the JSGen and WebDW formats |
Control the number of rows displayed on the page, generate HTML for a specific browser or HTML version, choose client-side features to incorporate into the page, select how to display drop-down DataWindows, select a paging method, and set up JavaScript caching to enhance performance. |
HTML.property (shared by all Web DataWindow formats) |
HTML category for a Column, Computed Field, Text, or Picture control in a DataWindow object |
Set up hyperlinks and retrieval arguments typically used to create master/detail Web pages, specify whether the content of a control should be rendered as HTML, and specify any HTML to be appended to a control. |
