Share via


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

See Also

Other Resources

Exchange Web Services XML Elements