CalculateDocumentVariableEventArgs.VariableName Property

Gets the name of the document variable to which the DOCVARIABLE field refers.

Namespace: DevExpress.XtraRichEdit

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

Declaration

C#

public string VariableName { get; }

VB.NET

Public ReadOnly Property VariableName As String

Property Value

Type	Description
String	A string that is the name of the document variable in the DOCVARIABLE field.

Remarks

The VariableName property enables you to identify a document variable for which the Document.CalculateDocumentVariable event is fired.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the VariableName property.

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#

dxrichedit-for-wpf-how-to-use-document-variable-docvariable-fields-e3282/CS/MainWindow.xaml.cs#L73

Console.WriteLine(e.VariableName + " " + location);

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

{
    if (e.VariableName == "Supplier") {
        // Create a text engine to process a document after the mail merge.

how-to-create-an-editor-similar-to-outlook-attachment-editor-e4911/CS/WindowsFormsApplication1/WindowsFormsApplication1/AttachmentsEditor.cs#L82

void Document_CalculateDocumentVariable(object sender, DevExpress.XtraRichEdit.CalculateDocumentVariableEventArgs e) {
    if(filesCollection.ContainsKey(e.VariableName)) {
        IRichEditDocumentServer server = richEditControl1.CreateDocumentServer();

how-to-create-nested-fields-programmatically-e4004/CS/Form1.cs#L47

private void richEditControl1_CalculateDocumentVariable(object sender, CalculateDocumentVariableEventArgs e) {
    e.Value = e.VariableName + "'s value";

how-to-replace-document-fields-with-their-values-e3482/CS/Form1.cs#L26

private void richEditControl1_CalculateDocumentVariable(object sender, DevExpress.XtraRichEdit.CalculateDocumentVariableEventArgs e) {
    if (e.VariableName == "dvField") {
        e.Value = "Test";

VB.NET

dxrichedit-for-wpf-how-to-use-document-variable-docvariable-fields-e3282/VB/MainWindow.xaml.vb#L73

Console.WriteLine(e.VariableName & " " & location)

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

Private Sub resultRichEdit_CalculateDocumentVariable(ByVal sender As Object, ByVal e As CalculateDocumentVariableEventArgs)
    If Equals(e.VariableName, "Supplier") Then
        ' Create a text engine to process a document after the mail merge.

how-to-create-an-editor-similar-to-outlook-attachment-editor-e4911/VB/WindowsFormsApplication1/AttachmentsEditor.vb#L86

Private Sub Document_CalculateDocumentVariable(ByVal sender As Object, ByVal e As DevExpress.XtraRichEdit.CalculateDocumentVariableEventArgs)
    If filesCollection.ContainsKey(e.VariableName) Then
        Dim server As IRichEditDocumentServer = richEditControl1.CreateDocumentServer()

how-to-create-a-master-detail-report-in-a-richeditcontrol-e3331/VB/RichEditMasterDetailMailMerge/Form1.vb#L71

'Check whether the event is raised to the required field:
If e.VariableName = "Categories" Then
    'Provide the data source for the next document part:

how-to-create-nested-fields-programmatically-e4004/VB/Form1.vb#L49

Private Sub richEditControl1_CalculateDocumentVariable(ByVal sender As Object, ByVal e As CalculateDocumentVariableEventArgs) Handles richEditControl1.CalculateDocumentVariable
    e.Value = e.VariableName & "'s value"