Back to Devexpress

RichEditControl.LoadDocument(Stream, DocumentFormat, String) Method

wpf-devexpress-dot-xpf-dot-richedit-dot-richeditcontrol-dot-loaddocument-x28-system-dot-io-dot-stream-devexpress-dot-xtrarichedit-dot-documentformat-system-dot-string-x29.md

latest3.4 KB
Original Source

RichEditControl.LoadDocument(Stream, DocumentFormat, String) Method

SECURITY-RELATED CONSIDERATIONS

Using file paths sourced from untrusted input may expose unauthorized files or allow unintended file access. Always validate and normalize all external paths to prevent path manipulation.

Loads a document from the stream in the specified format. External content for HTML format is retrieved using the specified source (base) URI.

Namespace : DevExpress.Xpf.RichEdit

Assembly : DevExpress.Xpf.RichEdit.v25.2.dll

NuGet Package : DevExpress.Wpf.RichEdit

Declaration

csharp
public virtual bool LoadDocument(
    Stream stream,
    DocumentFormat documentFormat,
    string sourceUri
)
vb
Public Overridable Function LoadDocument(
    stream As Stream,
    documentFormat As DocumentFormat,
    sourceUri As String
) As Boolean

Parameters

NameTypeDescription
streamStream

The stream from which to load the document.

| | documentFormat | DocumentFormat |

One of the DocumentFormat enumeration members, indicating the document format.

| | sourceUri | String |

A string representing the document URI.

|

Returns

TypeDescription
Boolean

true, if the document is successfully loaded; otherwise, false.

|

Remarks

The source stream can be non-seekable. In this case, the stream is buffered automatically. After loading the document, the stream remains open.

Tip

The method can be used to load HTML files with external references.

If the document is in a different format than specified or the passed stream is null , the RichEditControl.InvalidFormatException event fires.

Tip

Determine a moment when the document model can be safely modified using the RichEditControl.DocumentLoaded event. Call the LoadDocument method in the Form.Loaded event handler to work with the DocumentLoaded event. Handle the DocumentLayout.DocumentFormatted event to check the loaded document’s layout.

See Also

Troubleshooting

RichEditControl Class

RichEditControl Members

DevExpress.Xpf.RichEdit Namespace