How to: Specify Document Properties
- 3 minutes to read
This example demonstrates how to append document properties in code.
Specify Standard Document Properties
Use the Document.DocumentProperties property to specify standard document properties, as illustrated below.
Note
A complete sample project is available at https://github.com/DevExpress-Examples/word-processing-document-api-examples-t418535
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.
server.CreateNewDocument();
Document document = server.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();
Built-in Properties in Different Formats
The table below highlights what built-in document properties supported in different formats.
| DOCX | RTF | DOC | WordML | ODT | HTML | |
|---|---|---|---|---|---|---|
| Category |  |
|
|
|
 |
|
| ContentStatus | |
|
|
|
|
|
| ContentType | |
|
|
|
|
|
| Created | |
|
|
|
|
|
| Creator | |
|
|
|
|
|
| Description | |
|
|
|
|
|
| Identifier | |
|
|
|
|
|
| Keywords | |
|
|
|
|
|
| Language | |
|
|
|
|
|
| LastModifiedBy | |
|
|
|
|
|
| LastPrinted | |
|
|
|
|
|
| Modified | |
|
|
|
|
|
| Revision | |
|
|
|
|
|
| Subject | |
|
|
|
|
|
| Title | |
|
|
|
|
|
| Version | |
|
|
|
|
|
Create Custom Document Properties
To create a custom document property, a new item should be added to the corresponding collection, accessible through the Document.CustomProperties property. This can be done in two ways:
- Using the DocumentCustomProperties.Item property. It sets a value to the property with the name specified in square brackets. If the property with such name doesn’t exist, it will be created automatically.
Note
A complete sample project is available at https://github.com/DevExpress-Examples/word-processing-document-api-examples-t418535
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.Add("MyNumericProperty", 123.45);
document.CustomProperties.Add("MyStringProperty", "The Final Answer");
document.CustomProperties.Add("MyBooleanProperty", true);
server.CalculateDocumentVariable += DocumentPropertyDisplayHelper.OnCalculateDocumentVariable;
document.Fields.Update();
- Using DocumentCustomProperties.Add method, as illustrated below.
private void SetCustomProperties()
{
Document document = server.Document;
document.CustomProperties.Add("MyNumericProperty", 123.45);
document.CustomProperties.Add("MyStringProperty", "The Final Answer");
document.CustomProperties.Add("MyBookmarkProperty", document.Bookmarks[0]);
document.CustomProperties.Add("MyBooleanProperty", true);
}