UserProperties.Find Method

Outlook Developer Reference

Locates and returns a UserProperty object for the requested property name, if it exists.

Syntax

expression.Find(Name, Custom)

expression   A variable that represents an UserProperties object.

Parameters

Name Required/Optional Data Type Description
Name Required String The name of the requested property.
Custom Optional Variant True if custom properties on the item should be searched, False if built-in properties should be searched.

Return Value
If you use UserProperties.Find to look for a custom property and the call succeeds, it will return a UserProperty object. If it fails, it will return Null (Nothing in Visual Basic). If you use UserProperties.Find to look for a built-in property, specify False for the

Custom

parameter. If the call succeeds, it will return the property as a UserProperty object. If the call fails, it will return Null (Nothing in Visual Basic). If you specify True for

Custom

, the call will not find the built-in property and will return Null (Nothing in Visual Basic).

Remarks

If

Custom

parameter is True, only custom user properties will be searched. The default value is True. To find a non custom property such as Subject, specify

Custom

parameter as False, otherwise will return Nothing.

See Also