FindItem

Статья
03/29/2023

Элемент FindItem определяет запрос на поиск элементов в почтовом ящике.

<FindItem Traversal="">
   <ItemShape/>
   <IndexedPageItemView/>
   <GroupBy/>
   <Restriction/>
   <SortOrder/>
   <ParentFolderIds/>
   <QueryString/>
</FindItem>

<FindItem Traversal="">
   <ItemShape/>
   <IndexedPageItemView/>
   <DistinguishedGroupBy/>
   <Restriction/>
   <SortOrder/>
   <ParentFolderIds/>
   <QueryString/>
</FindItem>

<FindItem Traversal="">
   <ItemShape/>
   <ContactsView/>
   <GroupBy/>
   <Restriction/>
   <SortOrder/>
   <ParentFolderIds/>
   <QueryString/>
</FindItem>

<FindItem Traversal="">
   <ItemShape/>
   <ContactsView/> 
   <DistinguishedGroupBy/>
   <Restriction/>
   <SortOrder/>
   <ParentFolderIds/>
   <QueryString/>
</FindItem>

<FindItem Traversal="">
   <ItemShape/>
   <CalendarView/>
   <GroupBy/>
   <Restriction/>
   <SortOrder/>
   <ParentFolderIds/>
   <QueryString/>
</FindItem>

<FindItem Traversal="">
   <ItemShape/>
   <FractionalPageItemView/>
   <GroupBy/>
   <Restriction/>
   <SortOrder/>
   <ParentFolderIds/>
   <QueryString/>
</FindItem>

<FindItem Traversal="">
   <ItemShape/>
   <FractionalPageItemView/>
   <DistinguishedGroupBy/>
   <Restriction/>
   <SortOrder/>
   <ParentFolderIds/>
   <QueryString/>
</FindItem>

FindItemType

Атрибуты и элементы

В разделах ниже приводится описание атрибутов, дочерних и родительских элементов.

Атрибуты

Атрибут	Описание
Обхода	Определяет, находит ли поиск элементы в папках или в мусорных корзинах папок. Этот атрибут является обязательным.

Значения атрибутов обхода

Значение	Описание
Мелкой	Возвращает только удостоверения элементов в папке.
SoftDeleted	Возвращает только удостоверения элементов, которые находятся в контейнере папки. Обратите внимание, что обратимое удаление обхода в сочетании с ограничением поиска приведет к нулю возвращаемых элементов, даже если есть элементы, которые соответствуют условиям поиска.
Связанные	Возвращает только удостоверения связанных элементов в папке.

Дочерние элементы

Элемент	Описание
ItemShape	Определяет свойства и содержимое элемента, включаемые в ответ на операцию FindItem .
IndexedPageItemView	Описывает, как для запроса FindItem возвращаются сведения о страничном элементе. Этот элемент является необязательным.
FractionalPageItemView	Описывает место начала страничного представления и максимальное количество элементов, возвращенных в запросе FindItem . Смещение страничного представления от начала набора найденных элементов описывается дробью. Этот элемент является необязательным.
CalendarView	Предоставляет ограничения по времени для определения поиска элементов календаря. Этот элемент является необязательным.
ContactsView	Определяет поиск элементов контакта на основе отображаемых имен в алфавитном порядке. Этот элемент является необязательным.
GroupBy	Задает произвольные группировки для запросов FindItem . Этот элемент является необязательным.
DistinguishedGroupBy	Предоставляет стандартные группы для запросов FindItem . Этот элемент является необязательным.
Restriction	Определяет ограничение или запрос, используемый для фильтрации элементов или папок в операциях FindItem/ FindFolder и поиска папок. Этот элемент является необязательным.
SortOrder	Определяет порядок сортировки элементов в запросе FindItem. Этот элемент является необязательным.
ParentFolderIds	Определяет папки для поиска операций FindItem и FindFolder.
QueryString (QueryStringType)	Содержит строку запроса почтового ящика на основе расширенного синтаксиса запросов (AQS).

Родительские элементы

Нет.

Замечания

В запрос FindItem можно включить только один из элементов IndexedPageItemView, FractionalPageItemView, CalendarView или ContactsView. В запрос FindItem можно включить только один из элементов GroupBy или DistinguishedGroupBy.

Схема, описывающая этот элемент, находится в виртуальном каталоге IIS, в котором размещены веб-службы Exchange.

Сведения об элементе

Элемент	Пример
Пространство имен	https://schemas.microsoft.com/exchange/services/2006/messages
Имя схемы	Схема Messages
Файл проверки	Messages.xsd
Может быть пустым	False