Article
08/21/2009

Contains

Topic Last Modified: 2007-02-16

The Contains element represents a search expression that determines whether a given property contains the supplied constant string value.

Syntax

<Contains ContainmentMode="" ContainmentComparison="">
   <FieldURI/>
   <Constant/>
</Contains>

<Contains ContainmentMode="" ContainmentComparison="">
   <IndexedFieldURI/>
   <Constant/>
</Contains>

<Contains ContainmentMode="" ContainmentComparison="">
   <ExtendedFieldURI/>
   <Constant/>
</Contains>

Type

ContainsExpressionType

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute	Description
ContainmentMode	Identifies the boundaries of a search.
ContainmentComparison	Determines whether the search ignores cases and spaces.

ContainmentMode Attribute Values

Value	Description
FullString	The comparison is between the full string and the constant. The property value and the supplied constant are precisely the same.
Prefixed	The comparison is between the string prefix and the constant.
Substring	The comparison is between a substring of the string and the constant.
PrefixOnWords	The comparison is between a prefix on individual words in the string and the constant.
ExactPhrase	The comparison is between an exact phrase in the string and the constant.

ContainmentComparison Attribute Values

Value	Description
Exact	The comparison must be exact.
IgnoreCase	The comparison ignores casing.
IgnoreNonSpacingCharacters	The comparison ignores non-spacing characters.
Loose	To be removed.
IgnoreCaseAndNonSpacingCharacters	The comparison ignores casing and non-spacing characters.
LooseAndIgnoreCase	To be removed.
LooseAndIgnoreNonSpace	To be removed.
LooseAndIgnoreCaseAndIgnoreNonSpace	To be removed.

Child Elements

Element	Description
FieldURI	Identifies frequently referenced properties by URI.
IndexedFieldURI	Identifies individual members of a dictionary.
ExtendedFieldURI	Identifies MAPI properties.
Constant	Identifies a constant value in a restriction.

Parent Elements

Element	Description
Restriction	Represents the restriction or query that is used to filter items or folders in FindItem/FindFolder and search folder operations.
Not	Represents a search expression that negates the Boolean value of the search expression it contains.
And	Represents a search expression that allows you to perform a Boolean And operation between two or more search expressions. The result of the And operation is true if all of the search expressions contained within the And are true.
Or	Represents a search expression that performs a logical OR on the search expression it contains. The Or element will return true if any of its children return true.

Remarks

The attributes are used to determine how the elements are matched.

The schema that describes this element is located in the EWS virtual directory of the computer that is running Microsoft Exchange Server 2007 that has the Client Access server role installed.

Element Information

Namespace	https://schemas.microsoft.com/exchange/services/2006/types
Schema Name	Types schema
Validation File	Types.xsd
Can be Empty	False

Share via