Using HtmlFormatProvider
HtmlFormatProvider makes it easy to import and export RadFlowDocument to/from HTML format, preserving as much as possible of the document structure and formatting. To use HtmlFormatProvider, you should add references to the assemblies listed below:
- Telerik.Windows.Documents.Core.dll
- Telerik.Windows.Documents.Flow.dll
Import
In order to import an HTML document you can use the overloads of the HtmlFormatProvider.Import() method.
Example 1 shows how to use HtmlFormatProvider to import an HTML document from a file.
Example 1: Import HTML file
using (Stream input = File.OpenRead(@"Sample.html"))
{
Telerik.Windows.Documents.Flow.FormatProviders.Html.HtmlFormatProvider provider = new Telerik.Windows.Documents.Flow.FormatProviders.Html.HtmlFormatProvider();
//RadFlowDocument document = provider.Import(input); //This method is obsolete since Q4 2024.
RadFlowDocument document = provider.Import(input, TimeSpan.FromSeconds(10));
}
Example 2 shows how you can import an HTML string.
Example 2: Import HTML string
string html = "<p>hello world!</p>";
Telerik.Windows.Documents.Flow.FormatProviders.Html.HtmlFormatProvider provider = new Telerik.Windows.Documents.Flow.FormatProviders.Html.HtmlFormatProvider();
//RadFlowDocument document = provider.Import(html); //This method is obsolete since Q4 2024.
RadFlowDocument document = provider.Import(html, TimeSpan.FromSeconds(10));
The resulting RadFlowDocument can be used like any code-generated document.
Export
In order to export a document to HTML you can use the overloads of the HtmlFormatProvider.Export() method.
Example 3 shows how to use the HtmlFormatProvider to export an instance of RadFlowDocument to a file:
Example 3: Export HTML to file
Telerik.Windows.Documents.Flow.FormatProviders.Html.HtmlFormatProvider provider = new Telerik.Windows.Documents.Flow.FormatProviders.Html.HtmlFormatProvider();
using (Stream output = File.Create("Sample.html"))
{
RadFlowDocument document = CreateRadFlowDocument(); // CreateRadFlowDocument() is a custom method that creates a simple instance of RadFlowDocument. You can replace it with the instance you would like to export.
//provider.Export(document, output); //This method is obsolete since Q4 2024.
provider.Export(document, output, TimeSpan.FromSeconds(10));
}
You can also export the document to a string variable like shown in Example 4.
Example 4: Export HTML to string
RadFlowDocument document = CreateRadFlowDocument(); // CreateRadFlowDocument() is a custom method that creates a simple instance of RadFlowDocument. You can replace it with the instance you would like to export.
Telerik.Windows.Documents.Flow.FormatProviders.Html.HtmlFormatProvider provider = new Telerik.Windows.Documents.Flow.FormatProviders.Html.HtmlFormatProvider();
//string html = provider.Export(document); //This method is obsolete since Q4 2024.
string html = provider.Export(document, TimeSpan.FromSeconds(10));