# HTML Export

ActiveReports allows you to access the HTML export filter to display the reports on Web browsers or e-mail. Learn its limitations and output types in documentation.

## Content



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](/activereportsnet/api/v19.2/MESCIUS.ActiveReports.Export.Html/GrapeCity.ActiveReports.Export.Html.Section.HtmlExport.html) object after adding reference to **MESCIUS.ActiveReports.Export.Html** package in your project.

## HTML Export Filter Properties

| Property | Valid Values | Description |
| --- | --- | --- |
| [BookmarkStyle](/activereportsnet/api/v19.2/MESCIUS.ActiveReports.Export.Html/GrapeCity.ActiveReports.Export.Html.Section.HtmlExport.html) | 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](/activereportsnet/api/v19.2/MESCIUS.ActiveReports.Export.Html/GrapeCity.ActiveReports.Export.Html.Section.HtmlExport.html) | 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](/activereportsnet/api/v19.2/MESCIUS.ActiveReports.Export.Html/GrapeCity.ActiveReports.Export.Html.Section.HtmlExport.html) | 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](/activereportsnet/api/v19.2/MESCIUS.ActiveReports.Export.Html/GrapeCity.ActiveReports.Export.Html.Section.HtmlExport.html) | 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](/activereportsnet/api/v19.2/MESCIUS.ActiveReports.Export.Html/GrapeCity.ActiveReports.Export.Html.Section.HtmlExport.html) | True or False (default) | Set to True to include the report's margins in the HTML output. |
| [MultiPage](/activereportsnet/api/v19.2/MESCIUS.ActiveReports.Export.Html/GrapeCity.ActiveReports.Export.Html.Section.HtmlExport.html) | 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](/activereportsnet/api/v19.2/MESCIUS.ActiveReports.Export.Html/GrapeCity.ActiveReports.Export.Html.Section.HtmlExport.html) | 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. |
| [Pagination](/activereportsnet/api/v19.2/MESCIUS.ActiveReports.Export.Html/GrapeCity.ActiveReports.Export.Html.Section.HtmlExport.html) | True (default) or False | Gets or sets the value, that indicates whether to use pagination for the resultant html document. This property is only useful for Page/RDLX reports exports through RDF and does not affect a section report. |
| [RemoveVerticalSpace](/activereportsnet/api/v19.2/MESCIUS.ActiveReports.Export.Html/GrapeCity.ActiveReports.Export.Html.Section.HtmlExport.html) | 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](/activereportsnet/api/v19.2/MESCIUS.ActiveReports.Export.Html/GrapeCity.ActiveReports.Export.Html.Section.HtmlExport.html) | Any String | Enter the text to use in the header section's title. This is displayed in the title bar of the browser. |

## Additional Information on Output Types

By default, the report is exported as DynamicHtml (DHTML), with cascading style sheets (CSS). Using the [OutputType](/activereportsnet/api/v19.2/MESCIUS.ActiveReports.Export.Html/GrapeCity.ActiveReports.Export.Html.Section.HtmlExport.html) 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 and limitations

**Usage**:

*   Create Web reports with Cascading Style Sheets (CSS)
*   Open in Web browsers

**Does not support**:

*   Diagonal line control
*   Control borders

### LegacyHtml (HTML) usage and limitations

**Usage**:

*   Create archival reports
*   Open in Web browsers

**Does not support**:

*   Line control
*   Control borders
*   CrossSectionLine controls
*   Overlapping controls
*   MinCondenseRate property

## HTML Export Filter Limitations

*   Line spacing in exported HTML can be different from the line spacing in Viewer.
*   There may be space between the borders of each control in exported file.
*   Text in RichTextBox may appear overlapped.
*   Vertical Text and Bookmarks are not supported.
*   Any text may appear overlapped.
*   Borders are not supported.

## Export Report using HTML Export Filter

Use the following steps to export reports through HTML export filter.

1.  Create a new or open an existing Windows Forms App (.NET Framework or .NET) in Visual Studio project.
2.  Go to the Project Explorer, right-click the project and select **Add** > **New Item.**
3.  Select **ActiveReports 19 Standalone Report** > **Add** and choose **Section** report type, and then click **Finish**.<br />The xml-based Section report (report.rpx) is added.
4.  Add a reference to **MESCIUS.ActiveReports.Export.Html** package in the project. See [Manage ActiveReports Dependencies](/activereportsnet/docs/v19.2/devops/install-activereports/manage-ar-dependencies) for more information.
5.  In your project's **Bin>Debug** folder, place the **report.rpx** (Section Report).
6.  On the Form.cs or Form.vb, double-click the title bar to create the Form\_Load event.
7.  In **Form\_Load** event, add the following code to export Section Reports .
    
    ```vbnet
    ' Create a Section report.
    
    Dim rpt As New GrapeCity.ActiveReports.SectionReport()
    ' For the code to work, report.rpx must be placed in the bin\debug folder of your project.
    Dim xtr As New System.Xml.XmlTextReader(Application.StartupPath + "\report.rpx")
    rpt.LoadLayout(xtr)
    rpt.Run()
                       
    ' Export the report in HTML format.
    Dim HtmlExport1 As New GrapeCity.ActiveReports.Export.Html.Section.HtmlExport()
    HtmlExport1.Export(rpt.Document, Application.StartupPath + "\HTMLExpt.html")
    ```
    
    <br />
    
    ```csharp
    // Create a Section Report
    GrapeCity.ActiveReports.SectionReport rpt = new GrapeCity.ActiveReports.SectionReport();
    
    // For the code to work, report.rpx must be placed in the bin\debug folder of your project.
    System.Xml.XmlTextReader xtr = new System.Xml.XmlTextReader(Application.StartupPath + "\\report.rpx");
    rpt.LoadLayout(xtr);
    rpt.Run();
    
    // Export the report in HTML format.
    GrapeCity.ActiveReports.Export.Html.Section.HtmlExport HtmlExport1 = new GrapeCity.ActiveReports.Export.Html.Section.HtmlExport();
    HtmlExport1.Export(rpt.Document, Application.StartupPath + "\\HTMLExpt.html");
    ```