officefileapi-devexpress-dot-xtrarichedit-dot-api-dot-native-dot-subdocument-dot-appenddocumentcontent-x28-system-dot-string-devexpress-dot-xtrarichedit-dot-documentformat-system-dot-string-x29.md
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.
Appends content from the file.
Namespace : DevExpress.XtraRichEdit.API.Native
Assembly : DevExpress.RichEdit.v25.2.Core.dll
NuGet Package : DevExpress.RichEdit.Core
DocumentRange AppendDocumentContent(
string fileName,
DocumentFormat format,
string sourceUri
)
Function AppendDocumentContent(
fileName As String,
format As DocumentFormat,
sourceUri As String
) As DocumentRange
| Name | Type | Description |
|---|---|---|
| fileName | String |
A string representing a filename of the document whose content is being appended.
| | format | DocumentFormat |
A DocumentFormat enumeration specifying the format of the data contained in the file.
| | sourceUri | String |
A string representing the URI for the document being appended. Required to import formats with external content such as HTML.
|
| Type | Description |
|---|---|
| DocumentRange |
A DocumentRange representing a range with the appended content.
|
The AppendDocumentContent method imports the specified file into the internal document model. If the format parameter is set to DocumentFormat.Undefined, the importer attempts to auto detect the format of the specified file. The sourceUri parameter is passed to the importer, to allow the importer to use it when required. If the HTML-specific importer is created, the sourceUri is used to find pictures and other external content, such as .css files.
If the format auto detect fails, a fallback format is used. Currently the fallback format is plain text.
After the file is successfully imported, the new document model is inserted at the end of the main document.
The appended text starts with a new paragraph and preserves formatting. It is appended to an existing section and gets all section details (header, footer, page and print layout).
If the text being inserted contains document styles which are not present in the current document, the styles are copied to the resulting document.
If the document whose content is being inserted contains floating objects, such as pictures or text boxes, they are inserted into the corresponding positions in a newly created range.
See Also