FindFolderFindFolder

Элемент FindFolder определяет запрос на поиск папок в почтовом ящике.The FindFolder element defines a request to find folders in a mailbox.

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

финдфолдертипеFindFolderType

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

В следующих разделах описываются атрибуты, дочерние и родительские элементы.The following sections describe attributes, child elements, and parent elements.

АтрибутыAttributes

АтрибутAttribute ОписаниеDescription
ОбходTraversal
Определяет способ выполнения поиска.Defines how a search is performed. Этот атрибут является обязательным.This attribute is required.

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

ЗначениеValue ОписаниеDescription
ПоверхностShallow
Инструктирует операцию FindFolder для поиска только в идентифицированной папке и возврата только идентификаторов папок для элементов, которые не были удалены.Instructs the FindFolder operation to search only the identified folder and to return only the folder IDs for items that have not been deleted. Это называется неповерхностным обходом.This is called a shallow traversal.
УглубленDeep
Инструктирует операцию FindFolder для поиска во всех дочерних папках указанной родительской папки и возврата только идентификаторов папок для элементов, которые не были удалены.Instructs the FindFolder operation to search in all child folders of the identified parent folder and to return only the folder IDs for items that have not been deleted. Это называется глубоким обходом.This is called a deep traversal.
SoftDeletedSoftDeleted
Инструктирует операцию FindFolder для выполнения неполном обходного поиска для удаленных элементов.Instructs the FindFolder operation to perform a shallow traversal search for deleted items.

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

ЭлементElement ОписаниеDescription
фолдершапеFolderShape
Определяет свойства папки, включаемые в отклике FindFolder.Identifies the folder properties to include in a FindFolder response.
индекседпажефолдервиевIndexedPageFolderView
Описывает, как возвращаются сведения о страничном элементе в отклике FindFolder.Describes how paged item information is returned in a FindFolder response. Этот элемент является необязательным.This element is optional.
фрактионалпажефолдервиевFractionalPageFolderView
Описывает, где начинается страничное представление, и максимальное количество папок, возвращаемых в запросе FindFolder.Describes where the paged view starts and the maximum number of folders returned in a FindFolder request. Этот элемент является необязательным.This element is optional.
RestrictionRestriction
Определяет ограничение или запрос, используемый для фильтрации папок в операции FindFolder.Defines a restriction or query that is used to filter folders in a FindFolder operation. Этот элемент является необязательным.This element is optional.
парентфолдеридсParentFolderIds
Определяет папки для поиска в операции FindFolder.Identifies folders for the FindFolder operation to search.

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

Нет.None.

ПримечанияRemarks

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

ПримерExample

В следующем примере запроса FindFolder показано, как сформировать запрос на поиск всех папок, расположенных в папке "Входящие".The following example of a FindFolder request shows how to form a request to find all the folders located in an Inbox.

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
  <soap:Body>
    <FindFolder Traversal="Shallow" xmlns="https://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>

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

Пространство именNamespace
https://schemas.microsoft.com/exchange/services/2006/messages
Имя схемыSchema Name
Схема MessagesMessages schema
Файл проверкиValidation File
Messages. xsdMessages.xsd
Может быть пустымCan be Empty
FalseFalse

См. такжеSee also