Edit this page

Using HtmlFormatProvider

HtmlFormatProvider makes it easy to import and export RadDocument to/from HTML format, preserving as much as possible of the document structure and formatting.

To use HtmlFormatProvider, you should reference the Telerik.WinControls.RichTextEditor.dll assembly and add the following namespace:

  • Telerik.WinForms.Documents.FormatProviders.Html

Import

In order to import an HTML document you can use the overloads of the HtmlFormatProvider.Import() method.

The first example shows how to use HtmlFormatProvider to import an HTML document from a file.

Import Html File

HtmlFormatProvider provider = new HtmlFormatProvider();
using (FileStream inputStream = File.OpenRead(@"..\..\RichTextEditor\ImportExport\Sample.html"))
{
    this.radRichTextEditor1.Document = provider.Import(inputStream);
}

Dim provider As HtmlFormatProvider = New HtmlFormatProvider()
Using inputStream As FileStream = File.OpenRead("..\..\RichTextEditor\ImportExport\Sample.html")
    Me.radRichTextEditor1.Document = provider.Import(inputStream)
End Using

This example shows how you can import an HTML string.

Import Html String

string html = "<p>hello world!</p>";
HtmlFormatProvider provider = new HtmlFormatProvider();
this.radRichTextEditor1.Document = provider.Import(html);

Dim html As String = "<p>hello world!</p>"
Dim provider As HtmlFormatProvider = New HtmlFormatProvider()
Me.radRichTextEditor1.Document = provider.Import(html)

The resulting RadDocument can be used like any code-generated document.

Export

With the overloads of the Export method you can export the document to an HTML string or a file.

The first example shows how to use the HtmlFormatProvider to export an instance of RadDocument to a file:

Export Html to File

HtmlFormatProvider provider = new HtmlFormatProvider();
using (Stream output = File.OpenWrite("Sample.html"))
{
    RadDocument document = this.radRichTextEditor1.Document;
    provider.Export(document, output);
}

Dim provider As HtmlFormatProvider = New HtmlFormatProvider()
Using output As Stream = File.OpenWrite("Sample.html")
    Dim document As RadDocument = Me.radRichTextEditor1.Document
    provider.Export(document, output)
End Using

You can also export the document to a string variable like shown in the example below.

Export Html to String

RadDocument document = this.radRichTextEditor1.Document;
HtmlFormatProvider provider = new HtmlFormatProvider();
string html = provider.Export(document);

Dim document As RadDocument = Me.radRichTextEditor1.Document
Dim provider As HtmlFormatProvider = New HtmlFormatProvider()
Dim html As String = provider.Export(document)

See Also

Is this article helpful? Yes / No
Thank you for your feedback!

Give article feedback

Tell us how we can improve this article

close
Dummy