Back to Devexpress

RichEditDocumentServer.LoadDocument(Stream) Method

officefileapi-devexpress-dot-xtrarichedit-dot-richeditdocumentserver-dot-loaddocument-x28-system-dot-io-dot-stream-x29.md

latest4.6 KB
Original Source

RichEditDocumentServer.LoadDocument(Stream) Method

Loads a document from the stream.

Namespace : DevExpress.XtraRichEdit

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

NuGet Package : DevExpress.RichEdit.Core

Declaration

csharp
public bool LoadDocument(
    Stream stream
)
vb
Public Function LoadDocument(
    stream As Stream
) As Boolean

Parameters

NameTypeDescription
streamStream

A Stream object that is the stream used to load a document.

|

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.

The format of the document loaded from a stream is detected automatically by the built-in IFormatDetectorService service implementation. The following formats are detected:

  • DOC, DOCM, DOTX, DOT, DOTM, DOCX, RTF, HTM, HTML, MHT, XML, FlatOpc, EPUB;
  • ODT - non-encrypted files only;

Plain text cannot be detected automatically. To load a plain text document, use another method override with DocumentFormat.PlainText as a parameter.

If the format detection fails or the passed stream is null , the RichEditControl.InvalidFormatException event fires.

To determine the moment when the document model can be safely modified, use the RichEditDocumentServer.DocumentLoaded event. Handle the DocumentLayout.DocumentFormatted event to check the loaded document layout.

Tip

Define the format explicitly in the LoadDocument method overloads to improve performance.

The following code snippets (auto-collected from DevExpress Examples) contain references to the LoadDocument(Stream) method.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

office-file-api-in-web-api-app/CS/BusinessObjects/Helpers.cs#L19

csharp
{
    server.LoadDocument(inputStream);
    return SaveDocument(server, format);

office-file-api-dockerize-application/CS/DocumentConversionWebApi/Controllers/ConvertFileController.cs#L48

csharp
using (var wordProcessor = new RichEditDocumentServer()) {
    wordProcessor.LoadDocument(inputStream);
    var resultStream = new MemoryStream();

office-file-api-ai-implementation/CS/BusinessObjects/Helpers.cs#L50

csharp
stream.Seek(0, SeekOrigin.Begin);
    server.LoadDocument(stream);
}

See Also

RichEditDocumentServer Class

RichEditDocumentServer Members

DevExpress.XtraRichEdit Namespace