UserProperties.Find Method (Outlook)

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

Concepts

UserProperties Object

UserProperties Object Members