HTML, or hypertext markup language, is a format that opens in a Web browser. The HTML export filter has a number of useful properties that allow you to control your output. You can set the properties either in code using the HTMLExport object after adding reference to the following assembly in your project, or by selecting the object in the toolbox and adding it to the component tray below the Form which automatically adds this assembly to the project:
GrapeCity.ActiveReports.Export.Html.v8.dll
![](images/hs-note.gif) |
Note: HTML Export requires the .NET Framework full profile version. To ensure you are using the full profile version, go to the Visual Studio Project menu > Properties > Compile tab > Advanced Compile Options (for Visual Basic projects) or to the Project menu > Properties > Application tab (for C# projects) and under Target framework select a full profile version. |
HTML Export Properties
Property |
Valid Values |
Description |
BookmarkStyle |
Html (default) or None |
Set to Html to generate a page of bookmarks from the bookmarks in the report. If the report has no bookmarks, this setting is ignored. |
CharacterSet |
Big5, EucJp, HzGb2312, Ibm850, Iso2022Jp, Iso2022Kr, Iso8859_1, Iso8859_2, Iso8859_5, Iso8859_6, Koi8r, Ksc5601, ShiftJis, UnicodeUtf16, UnicodeUtf8 (default) |
Select the IANA character set that you want to use in the meta tag in the header section of the HTML output. This property only takes effect if the IncludeHtmlHeader property is set to True. |
CreateFramesetPage |
True or False (default) |
Set to True to generate a set of frames that display a page of bookmarks (if available) in the left frame and the report document in the right frame. The HTML output uses the specified filename with the extension .frame.html. |
IncludeHtmlHeader |
True (default) or False |
Set to False if you want to embed the HTML output in another HTML document. Otherwise, the HTML output includes the usual HTML, HEAD, and BODY elements. |
IncludePageMargins |
True or False (default) |
Set to True to include the report's margins in the HTML output. |
MultiPage |
True or False (default) |
Set to True to create a separate HTML page for each page of the report. Otherwise, the HTML output is a single page. |
OutputType |
DynamicHtml (default) or LegacyHtml |
Set to LegacyHtml to use tables for positioning and avoid the use of cascading style sheets (CSS). Otherwise, positioning of controls is handled in the CSS. |
RemoveVerticalSpace |
True or False (default) |
Set to True if the OutputType property is set to LegacyHtml and you plan to print the output from a browser. This removes white space from the report to help improve pagination. Otherwise, vertical white space is kept intact. |
Title |
Any String |
Enter the text to use in the header section's title. This is displayed in the title bar of the browser. |
More information on output types
By default, the report is exported as DynamicHtml (DHTML), with cascading style sheets (CSS). Using the OutputType property, you can change the output to LegacyHtml (HTML). Neither of the output types creates a report that looks exactly like the one you display in the viewer because of differences in formats. Following is the usage of each output type and controls to avoid in each.
DynamicHtml (DHTML)
Usage:
- Create Web reports with Cascading Style Sheets (CSS)
- Open in Web browsers
Does not support:
- Diagonal line control
- Control borders
LegacyHtml (HTML)
Usage:
- Create archival reports
- Open in Web browsers
Does not support:
- Line control
- Control borders
- CrossSectionLine controls
- Overlapping controls
See Also