DOCPROPERTY

• Sep 19, 2023
• 3 minutes to read

Non-MailMerge field

{ DOCPROPERTY “Name” }

Inserts the value of the document property specified by its name. A name is looked up in the core document property names (Document.DocumentProperties) and subsequently, if not found, in the Document.CustomProperties collection.

Core Document Properties

View Example: Word Processing Document API – How to Process Word Documents in Code

This code snippet demonstrates how to set standard document properties and show them in a document using specific fields. The FieldCollection.Update method updates all property fields in the document body.

Note

If the DOCPROPERTY fields are located in the text box, header or footer, they should be updated separately. Use the Section.BeginUpdateHeader - Section.EndUpdateHeader or Section.BeginUpdateFooter - Section.EndUpdateFooter paired methods to obtain the header or footer. The TextBox.Document property allows you to retrieve the text box content and update the corresponding fields.

DocumentPropertiesActions.cs

using XtraRichEdit.API.Native;
//...

using (var wordProcessor = new RichEditDocumentServer()) {
    wordProcessor.CreateNewDocument();
    Document document = wordProcessor.Document;
    document.BeginUpdate();

    document.DocumentProperties.Creator = "John Doe";
    document.DocumentProperties.Title = "Inserting Custom Properties";
    document.DocumentProperties.Category = "TestDoc";
    document.DocumentProperties.Description = "This code demonstrates API to modify and display standard document properties.";

    document.Fields.Create(document.AppendText("\nAUTHOR: ").End, "AUTHOR");
    document.Fields.Create(document.AppendText("\nTITLE: ").End, "TITLE");
    document.Fields.Create(document.AppendText("\nCOMMENTS: ").End, "COMMENTS");
    document.Fields.Create(document.AppendText("\nCREATEDATE: ").End, "CREATEDATE");
    document.Fields.Create(document.AppendText("\nCategory: ").End, "DOCPROPERTY Category");
    document.Fields.Update();
    document.EndUpdate();
}

DocumentPropertiesActions.vb

Imports Microsoft.VisualBasic
Imports XtraRichEdit.API.Native
'...

Using wordProcessor = New RichEditDocumentServer()
    wordProcessor.CreateNewDocument()
    Dim document As Document = wordProcessor.Document
    document.BeginUpdate()

    document.DocumentProperties.Creator = "John Doe"
    document.DocumentProperties.Title = "Inserting Custom Properties"
    document.DocumentProperties.Category = "TestDoc"
    document.DocumentProperties.Description = "This code demonstrates API to modify and display standard document properties."

    document.Fields.Create(document.AppendText(vbLf & "AUTHOR: ").End, "AUTHOR")
    document.Fields.Create(document.AppendText(vbLf & "TITLE: ").End, "TITLE")
    document.Fields.Create(document.AppendText(vbLf & "COMMENTS: ").End, "COMMENTS")
    document.Fields.Create(document.AppendText(vbLf & "CREATEDATE: ").End, "CREATEDATE")
    document.Fields.Create(document.AppendText(vbLf & "Category: ").End, "DOCPROPERTY Category")
    document.Fields.Update()
    document.EndUpdate()
End Using

The following names are recognized as core document properties:

Name	Document Property
Application	DocumentProperties.Application
AppVersion	DocumentProperties.AppVersion
Author	DocumentProperties.Author
Category	DocumentProperties.Category
Comments	DocumentProperties.Description
Company	DocumentProperties.Company
CreateTime	DocumentProperties.Created
Keywords	DocumentProperties.Keywords
LastPrinted	DocumentProperties.LastPrinted
LastSavedBy	DocumentProperties.LastModifiedBy
LastSavedTime	DocumentProperties.Modified
Manager	DocumentProperties.Manager
RevisionNumber	DocumentProperties.Revision
Subject	DocumentProperties.Subject
Title	DocumentProperties.Title

Custom Document Properties

A custom document property is specified by its name in double quotes.

View Example

DocumentPropertiesActions.cs

server.CreateNewDocument();
Document document = server.Document;
document.BeginUpdate();
document.Fields.Create(document.AppendText("\nMyNumericProperty: ").End, "DOCVARIABLE CustomProperty MyNumericProperty");
document.Fields.Create(document.AppendText("\nMyStringProperty: ").End, "DOCVARIABLE CustomProperty MyStringProperty");
document.Fields.Create(document.AppendText("\nMyBooleanProperty: ").End, "DOCVARIABLE CustomProperty MyBooleanProperty");
document.EndUpdate();

document.CustomProperties["MyNumericProperty"]= 123.45;
document.CustomProperties["MyStringProperty"]="The Final Answer";
document.CustomProperties["MyBooleanProperty"]=true;

server.CalculateDocumentVariable += DocumentPropertyDisplayHelper.OnCalculateDocumentVariable;
document.Fields.Update();

DocumentPropertiesActions.vb

server.CreateNewDocument()
Dim document As Document = server.Document
document.BeginUpdate()
document.Fields.Create(document.AppendText(vbLf & "MyNumericProperty: ").End, "DOCVARIABLE CustomProperty MyNumericProperty")
document.Fields.Create(document.AppendText(vbLf & "MyStringProperty: ").End, "DOCVARIABLE CustomProperty MyStringProperty")
document.Fields.Create(document.AppendText(vbLf & "MyBooleanProperty: ").End, "DOCVARIABLE CustomProperty MyBooleanProperty")
document.EndUpdate()

document.CustomProperties("MyNumericProperty")= 123.45
document.CustomProperties("MyStringProperty")="The Final Answer"
document.CustomProperties("MyBooleanProperty")=True

AddHandler server.CalculateDocumentVariable, AddressOf DocumentPropertyDisplayHelper.OnCalculateDocumentVariable
document.Fields.Update()