FindFolder

Статья
03/29/2023

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

<FindFolder Traversal="Shallow/Deep/SoftDeleted">
   <FolderShape/>
   <IndexedPageFolderView/>
   <Restriction/>
   <ParentFolderIds/>
</FindFolder>

<FindFolder Traversal="Shallow/Deep/SoftDeleted">
   <FolderShape/>
   <FractionalPageFolderView/>
   <Restriction/>
   <ParentFolderIds/>
</FindFolder>

FindFolderType

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

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

Атрибуты

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

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

Значение	Описание
Мелкой	Указывает операции FindFolder выполнять поиск только в указанной папке и возвращать только идентификаторы папок для элементов, которые не были удалены. Это называется неглубоким обходом.
Глубоко	Указывает операции FindFolder выполнить поиск во всех дочерних папках идентифицированной родительской папки и возвратить только идентификаторы папок для элементов, которые не были удалены. Это называется глубоким обходом.
SoftDeleted	Указывает операции FindFolder выполнить неглубокий обход для поиска удаленных элементов.

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

Элемент	Описание
FolderShape	Определяет свойства папки для включения в ответ FindFolder.
IndexedPageFolderView	Описывает, как в ответе FindFolder возвращаются сведения о страничном элементе. Этот элемент является необязательным.
FractionalPageFolderView	Описывает, где начинается выстраивание представления и максимальное количество папок, возвращенных в запросе FindFolder. Этот элемент является необязательным.
Restriction	Определяет ограничение или запрос, используемый для фильтрации папок в операции FindFolder. Этот элемент является необязательным.
ParentFolderIds	Определяет папки для операции FindFolder для поиска.

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

Нет.

Замечания

Схема, описывающая этот элемент, расположена в виртуальном каталоге EWS на компьютере, работающем под управлением Microsoft Exchange Server 2007, с установленной ролью сервера клиентского доступа.

Пример

В следующем примере запроса FindFolder показано, как сформировать запрос на поиск всех папок, расположенных в папке "Входящие".

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
  <soap:Body>
    <FindFolder Traversal="Shallow" xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
      <FolderShape>
        <t:BaseShape>Default</t:BaseShape>
      </FolderShape>
      <ParentFolderIds>
        <t:DistinguishedFolderId Id="inbox"/>
      </ParentFolderIds>
    </FindFolder>
  </soap:Body>
</soap:Envelope>

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

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

См. также

FindFolder Operation

Поделиться через