RichEditDocumentServer.MailMerge(IRichEditDocumentServer) Method

OBSOLETE

This method has become obsolete. Use another MailMerge method overload with appropriate parameters instead.

Merges the current document and sends the result to the specified RichEditDocumentServer instance.

Namespace: DevExpress.XtraRichEdit

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

NuGet Packages: DevExpress.RichEdit.Core, DevExpress.Win.Navigation

Declaration

C#

[Browsable(false)]
[Obsolete("This method has become obsolete. Use another MailMerge method overload with appropriate parameters instead.")]
public void MailMerge(
    IRichEditDocumentServer documentServer
)

VB.NET

<Browsable(False)>
<Obsolete("This method has become obsolete. Use another MailMerge method overload with appropriate parameters instead.")>
Public Sub MailMerge(
    documentServer As IRichEditDocumentServer
)

Parameters

Name	Type	Description
documentServer	IRichEditDocumentServer	An object implementing the IRichEditDocumentServer interface, such as the RichEditDocumentServer or the RichEditControl instance.

Remarks

Use this method to process the resulting document in the RichEditDocumentServer. For example, if merge fields are nested within DOCVARIABLE fields, you can call the FieldCollection.Update method to calculate filed content by handling the RichEditDocumentServer.CalculateDocumentVariable event.

Note that the CalculateDocumentVariable event is also raised for the object with the IRichEditDocumentServer interface, passed as an argument to the MailMerge method.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the MailMerge(IRichEditDocumentServer) 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.

C#

word-document-api-create-master-detail-report/CS/MasterDetailExample/MergeProcessor.cs#L77

// The CalculateDocumentVariable event for the richServerMaster fires.
suppllierRichEdit.MailMerge(richServerMaster);
richServerMaster.CalculateDocumentVariable -= richServerMaster_CalculateDocumentVariable;

VB.NET

word-document-api-create-master-detail-report/VB/MasterDetailExample/MergeProcessor.vb#L72

' The CalculateDocumentVariable event for the richServerMaster fires.
suppllierRichEdit.MailMerge(richServerMaster)
RemoveHandler richServerMaster.CalculateDocumentVariable, AddressOf richServerMaster_CalculateDocumentVariable

Implements

MailMerge(IRichEditDocumentServer)