CustomDocumentProperties Element (Microsoft Office)

Specifies a document's custom properties.

Contained In

XML

Subelements

Each subelement is determined by a custom document property name, type, and value.

Remarks

This element contains information about the user-defined custom document properties. Office applications provide preset names for custom document properties but also allow users to create their own names. For each custom document property, the user selects the data type from a drop-down list (such as Text or Number, and then enters a value for the custom document property.

Each CustomDocumentProperties subelement contains information from an individual custom document property defined for the document. CustomDocumentProperties subelements have the following attributes:

Attribute Description
dt:dt Specifies the data type for the custom document property. The possible values for this attribute are:
  • boolean
  • date
  • float
  • string
link Specifies the custom document property value's link to specific contents in a file. For example, the value might be linked to bookmarked text in the document.

The following syntax shows how a CustomDocumentProperties subelement is formed, where Name is the custom document property name, Type is its type, and Value is its value:

<o:Name dt:dt="Type">Value</o:Name>

See Also

DocumentProperties

Example

This example shows a Microsoft Word document with the following four custom document properties defined.

 
Name Type Value
Group (preset name) Text Marketing
Date Submitted Date 6/30/1999
Approved Yes or No Yes
Client (preset name) Text Microsoft Corporation
Linked to content in the document by a bookmark called "ClientName."		 

 <o:CustomDocumentProperties>
  <o:Group dt:dt="string">Marketing</o:Group>
  <o:Date_x0020_Submitted dt:dt="date">1999-06-30T07:00:00Z</o:Date_x0020_Submitted>
  <o:Approved dt:dt="boolean">1</o:Approved>
  <o:Client dt:dt="string" link="ClientName">Microsoft Corporation</o:Client>
 </o:CustomDocumentProperties>

Any character spaces in the CustomDocumentProperties subelement tag names are replaced with the string "_x0020_" to prevent compiler misinterpretation.