SubDocument.GetDotxBytes(DocumentRange, DotxDocumentExporterOptions) Method

Exports the range content in DOTX (Microsoft Office Open XML macro-free template) format and returns a byte array with this content.

Namespace: DevExpress.XtraRichEdit.API.Native

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

NuGet Package: DevExpress.RichEdit.Core

Declaration

C#

byte[] GetDotxBytes(
    DocumentRange range,
    DotxDocumentExporterOptions options
)

VB.NET

Function GetDotxBytes(
    range As DocumentRange,
    options As DotxDocumentExporterOptions
) As Byte()

Parameters

Name	Type	Description
range	DocumentRange	The range to convert to DOTX format.
options	DotxDocumentExporterOptions	An object that contains export options.

Returns

Type	Description
Byte[]	The range content in DOTX format.

Remarks

If you work with a selection range, make sure that the GetDotxBytes method is enclosed with the DocumentRange.BeginUpdateDocument - DocumentRange.EndUpdateDocument method pair. Otherwise, an incorrect document model might be selected, and the “Error: specified document position or range belongs to other document or subdocument” exception is thrown.

To retrieve section settings, make sure that the range contains the last section’s paragraph. Otherwise, the section settings are reset to default.

C#

using (RichEditDocumentServer wordProcessor = new RichEditDocumentServer())
{
    wordProcessor.LoadDocument("FirstLook.docx");
    Document document = wordProcessor.Document;
    DotxDocumentExporterOptions exportOptions = wordProcessor.Options.Export.Dotx;
    exportOptions.ExportedDocumentProperties = DocumentPropertyNames.None;
    byte[] bytes = document.GetDotmBytes(document.Range, exportOptions);
    File.WriteAllBytes(@"D:\testdoc.dotx", bytes);
}

VB.NET

Using wordProcessor As New RichEditDocumentServer()
  wordProcessor.LoadDocument("FirstLook.docx")
  Dim document As Document = wordProcessor.Document
  Dim exportOptions As DotxDocumentExporterOptions = wordProcessor.Options.Export.Dotx
  exportOptions.ExportedDocumentProperties = DocumentPropertyNames.None
  Dim bytes() As Byte = document.GetDotxBytes(document.Range, exportOptions)
  File.WriteAllBytes("D:\testdoc.dotx", bytes)
End Using