Export (0) Print
Expand All

Creating a Property

Outlook provides several ways to add custom properties:

UserProperties.Add

ItemProperties.Add

PropertyAccessor.SetProperty

PropertyAccessor.SetProperties

Action

Adds a custom property specified by Name and Type. If a property of the same name and type already exists, it will be overwritten by a new property. The default value for AddToFolderFields allows adding the property to the item and as a view field to the folder.

Adds a custom property specified by Name and Type even if a property of the same name and type already exists. The default value for AddToFolderFields allows adding the property to the item and as a view field to the folder.

Adds a custom property specified by SchemaName if the provider and the parent object supports property creation, the property does not already exist, and a valid schema name is specified for the property.

For each property in SchemaNames, PropertyAccessor.SetProperties adds it as a custom property if the provider and the parent object supports property creation, the property does not already exist, and a valid schema name is specified for the property.

Applicable Objects

All Outlook item objects except Microsoft Office document items (DocumentItem objects)

All Outlook item objects except Microsoft Office document items (DocumentItem objects)

All Outlook item objects including DocumentItem objects.

All Outlook item objects including DocumentItem objects.

Property Initial Value

Empty in VBA; requires subsequent assignment

Empty in VBA; requires subsequent assignment

Specified by Value.

Specified by the value of the corresponding element in the Values array

Property Type

Specified by Type

Specified by Type

If the property is specified by the MAPI proptag or id namespace, the property type is contained in the lowest 16 bits of the identifier; otherwise the property type is determined by the type of Value.

Type of each property is determined by the same principles as in the SetProperty column; where the property is not specified by any namespace involving its proptag, its property type is the type of the corresponding element in the Values array.

Upon Property Change

The CustomPropertyChange event will fire on property change.

The CustomPropertyChange event will fire on property change.

An item-level property added this way does not become part of the item's UserProperties collection. It will not generate Outlook Object Model events when it is changed.

Same event considerations as in the SetProperty column.

Show:
© 2014 Microsoft