This section describes the XML, XHTML, and HTML DataWindow object properties for the Web DataWindow that you can set in DataWindow Designer or in code, using the Modify or SetProperty methods.
Some properties that you can set for the DataWindow object in DataWindow Designer can also be set in the Properties window in Visual Studio .NET. 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 view, 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 |
User interface fields |
Description |
|---|---|---|
Data.XHTML |
Read only, so no user interface field |
A string containing the row data content of the DataWindow object in XHTML format |
Data.XMLWeb |
Read only, so no user interface field |
A string containing browser-specific JavaScript that performs the XSLT transformation on the browser |
Table 10-3 lists properties supporting XML Web DataWindow generation. If you set the XmlConfigurations.UrlPath property in the properties window in Visual Studio .NET, the JSGen, XMLGen, and XSLTGen ResourceBase and PublishPath properties are ignored.
Property |
User interface fields |
Allows you to |
|---|---|---|
CSSGen.property |
Web Generation property page with CSS selected as the format to configure: resource base, publish path, and session-specific file names |
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 |
JavaScript Generation property page with XHTML selected as the format to configure: resource base and publish path |
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 |
Web Generation property page with XML selected as the format to configure: resource base, publish path, and secure inline XML generation |
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 |
Web Generation property page with XSLT selected as the format to configure: resource base and publish path |
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 |
Web Generation property page with XHTML selected as the format to configure: browser |
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 |
User interface fields |
Allows you to |
|---|---|---|
HTMLDW (shared by all Web DataWindow formats) |
Web DataWindow check box on the General page of the DataWindow object Property view. Selecting this check box sets this property to Yes. |
View the HTML in a browser using Design>HTML Preview. |
HTMLTable.property (HTML only) |
All fields on the HTML Table page of the DataWindow object Property view. |
Change the display characteristics of HTML tables, including border style and cell width and padding. |
HTMLGen.property (shared by all Web DataWindow formats) |
All fields on the Web Generation page and the JavaScript Generation page of the DataWindow object Property view. (You can also start the JavaScript Generation wizard using the Generate File button on the JavaScript Generation page). |
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) |
All fields on the HTML page of the Property view 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. |
