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


ExtendedFieldURI

Элемент ExtendedFieldURI определяет расширенное свойство MAPI.

<ExtendedFieldURI DistinguishedPropertySetId="" PropertySetId="" PropertyTag="" PropertyName="" PropertyId="" PropertyType="" />

PathToExtendedFieldType

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

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

Атрибуты

Атрибут Описание
DistinguishedPropertySetId
Определяет известные идентификаторы наборов свойств для расширенных свойств MAPI.

Если этот атрибут используется, нельзя использовать атрибуты PropertySetId и PropertyTag . Этот атрибут должен использоваться с атрибутом PropertyId или PropertyName , а также с атрибутом PropertyType .

В таблице Атрибуты DistinguishedPropertySetId далее в этом разделе перечислены возможные значения для этого атрибута.

Этот атрибут является необязательным.
PropertySetId
Определяет расширенный набор свойств MAPI или пространство имен по идентификатору GUID.

Если этот атрибут используется, нельзя использовать атрибуты DistinguishedPropertySetId и PropertyTag . Этот атрибут должен использоваться с атрибутом PropertyId или PropertyName , а также с атрибутом PropertyType .

Этот атрибут является необязательным.
PropertyTag
Идентифицирует тег свойства без части типа тега. Объект PropertyTag можно представить в виде шестнадцатеричного или короткого целого числа.

Диапазон между 0x8000 и 0xFFFE представляет настраиваемый диапазон свойств. Когда база данных почтового ящика впервые обнаруживает пользовательское свойство, она назначает ему тег свойства в диапазоне настраиваемых свойств 0x8000-0xFFFE. Заданный настраиваемый тег свойства, скорее всего, будет отличаться в разных базах данных. Таким образом, настраиваемый запрос свойства по тегу свойства может возвращать различные свойства в разных базах данных. Использование атрибута PropertyTag запрещено для пользовательских свойств. Вместо этого используйте атрибут PropertySetId и атрибут PropertyName или PropertyId .

ВАЖНО! Доступ к любому пользовательскому свойству между 0x8000 и 0xFFFE с помощью GUID + имя или идентификатор. Если используется атрибут PropertyTag , нельзя использовать атрибуты DistinguishedPropertySetId, PropertySetId, PropertyName и PropertyId .

Этот атрибут является необязательным.

ПРИМЕЧАНИЕ. Атрибут тега свойства нельзя использовать для свойств в настраиваемом диапазоне 0x8000 0xFFFE. В этом случае необходимо использовать именованное свойство.
PropertyName
Определяет расширенное свойство по его имени. Это свойство должно быть сопряжено с DistinguishedPropertySetId или PropertySetId.

Если этот атрибут используется, нельзя использовать атрибуты PropertyId и PropertyTag .

Этот атрибут является необязательным.
PropertyId
Определяет расширенное свойство по идентификатору отправки. Идентификатор отправки можно определить в десятичном или шестнадцатеричном формате. Это свойство должно быть сопряжено с DistinguishedPropertySetId или PropertySetId.

Если этот атрибут используется, нельзя использовать атрибуты PropertyName и PropertyTag .

Этот атрибут является необязательным.
PropertyType
Представляет тип свойства тега свойства. Это соответствует наименее значимому слову в теге свойства.

Таблица PropertyType Attribute далее в этом разделе содержит возможные значения для этого атрибута.

Этот атрибут является обязательным.

Атрибут DistinguishedPropertySetId

Значение Описание
Address
Идентифицирует идентификатор свойства адреса по имени.
Appointment
Идентифицирует свойство встречи, заданное по имени.
CalendarAssistant
Определяет свойство помощника по календарю, заданное идентификатором по имени.
Распространенная
Определяет идентификатор набора общих свойств по имени.
InternetHeaders
Идентифицирует идентификатор свойства заголовков Интернета по имени.
Собрание
Определяет идентификатор свойства собрания, заданного по имени.
Общий доступ

PublicStrings
Идентифицирует идентификатор свойства открытых строк по имени.
Задача
Определяет идентификатор набора свойств задачи по имени.
UnifiedMessaging
Определяет свойство единой системы обмена сообщениями, заданное идентификатором по имени.

Атрибут PropertyType

Значение Описание
ApplicationTime
Двойное значение, интерпретируемое как дата и время. Целочисленная часть — это дата, а часть дроби — время.
ApplicationTimeArray
Массив двойных значений, которые интерпретируются как дата и время.
Binary
Двоичное значение в кодировке Base64.
BinaryArray
Массив двоичных значений в кодировке Base64.
Boolean
Логическое значение true или false.
CLSID
Строка GUID.
CLSIDArray
Массив строк GUID.
Валюта
64-разрядное целое число, которое интерпретируется как число центов.
CurrencyArray
Массив из 64-разрядных целых чисел, которые интерпретируются как число центов.
Двойное с плавающей точкой
64-разрядное значение с плавающей запятой.
DoubleArray
Массив 64-разрядных значений с плавающей запятой.
Error
Значение SCODE; 32-разрядное целое число без знака.
Не используется для ограничений или для получения и установки значений. Он существует только для создания отчетов.
С плавающей запятой
32-разрядное значение с плавающей запятой.
FloatArray
Массив 32-разрядных значений с плавающей запятой.
Целое число
32-разрядное целое число со знаком (Int32).
IntegerArray
Массив со знаком 32-разрядных целых чисел (Int32).
Длинное целое
64-разрядное целое число со знаком или без знака (Int64).
LongArray
Массив со знаком или без знака 64-разрядных целых чисел (Int64).
Null
Указывает отсутствие значения свойства.
Не используется для ограничений или для получения и установки значений. Он существует только для создания отчетов.
Объект
Указатель на объект, реализующий интерфейс IUnknown.
Не используется для ограничений или для получения и установки значений. Он существует только для создания отчетов.
ObjectArray
Массив указателей на объекты, реализующие интерфейс IUnknown.
Не используется для ограничений или для получения и установки значений. Он существует только для создания отчетов.
Короткие
16-разрядное целое число со знаком.
ShortArray
Массив со знаком 16-разрядных целых чисел.
Systemtime
64-разрядные целочисленные данные и значение времени в виде структуры FILETIME.
SystemTimeArray
Массив 64-разрядных целочисленных данных и значений времени в виде структуры FILETIME.
Строка
Строка Юникода.
StringArray
Массив строк Юникода.

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

Нет.

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

Элемент Описание
ExtendedProperty
Определяет расширенные свойства папок и элементов.
AdditionalProperties
Определяет дополнительные свойства.

Ниже приведены выражения XPath для этому элементу:

/FindFolder/FolderShape/AdditionalProperties
/GetFolder/FolderShape/AdditionalProperties
/SyncFolderHierarchy/FolderShape/AdditionalProperties
/GetItem/ItemShape/AdditionalProperties
/FindItem/ItemShape/AdditionalProperties
/SyncFolderItems/ItemShape/AdditionalProperties
/GetAttachment/AttachmentShape/AdditionalProperties
SetItemField
Представляет обновление одного свойства элемента в операции UpdateItem.
SetFolderField
Представляет обновление одного свойства в папке в операции UpdateFolder.
DeleteItemField
Представляет операцию удаления для удаления заданного свойства из элемента во время операции UpdateItem.
DeleteFolderField
Представляет операцию удаления для удаления заданного свойства из папки во время вызова UpdateFolder.
AppendToItemField
Определяет данные для добавления к одному свойству элемента во время операции UpdateItem.
AppendToFolderField
Указывает данные, добавляемые в свойство папки во время операции UpdateFolder.
Exists
Представляет выражение поиска, возвращающее значение true , если указанное свойство существует в элементе.
FieldURIOrConstant
Представляет свойство или константное значение, используемое при сравнении с другим свойством.
IsEqualTo
Представляет выражение поиска, которое сравнивает свойство с константой или другим свойством и вычисляет значение true , если они равны.
IsGreaterThan
Представляет выражение поиска, которое сравнивает свойство с константой или другим свойством и возвращает значение true , если первое свойство больше.
IsGreaterThanOrEqualTo
Представляет выражение поиска, которое сравнивает свойство с константой или другим свойством и возвращает значение true , если первое свойство больше или равно второму.
IsLessThan
Представляет выражение поиска, которое сравнивает свойство с константой или другим свойством и возвращает значение true , если первое свойство меньше второго.
IsLessThanOrEqualTo
Представляет выражение поиска, которое сравнивает свойство с константой или другим свойством и возвращает значение true , если первое свойство меньше второго.
IsNotEqualTo
Представляет выражение поиска, которое сравнивает свойство с константой или другим свойством и возвращает значение true , если значения не совпадают.
Исключает
Выполняет побитовую маску свойств.
Contains
Представляет выражение поиска, определяющее, содержит ли данное свойство указанное строковое значение константы.
FieldOrder
Представляет одно поле, по которому сортируются результаты, и указывает направление сортировки.

Замечания

Некоторые атрибуты нельзя использовать в сочетании с другими атрибутами. Любой запрос, который поставляется с недопустимым сочетанием атрибутов расширенных свойств, создаст сообщение об ошибке.

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

Примечание.

В Microsoft .NET long — это 64-разрядное целое число со знаком, а в MAPI и COM — 32-разрядное целое число. Большинство разработчиков будут использовать Microsoft.NET Framework для разработки клиентских приложений веб-служб Exchange. Поэтому вместо именования MAPI используется именование .NET.

Например, свойство MAPI PR_MESSAGE_FLAGS 0x0E07 является типом PT_LONG. В .NET это считается целым числом. Расширенное свойство для PR_MESSAGE_FLAGS определяется как <t:ExtendedFieldURI PropertyTag="0x0E07" PropertyType="Integer"/>.

Пример

В следующем примере запроса создается элемент с двумя настраиваемыми свойствами. Первое пользовательское свойство называется IsMyHouse с логическим значением true. Второе пользовательское расширенное свойство называется HousePrices. Он содержит массив значений currency.

<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
               xmlns:xsd="http://www.w3.org/2001/XMLSchema"
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
  <soap:Body>
    <CreateItem xmlns="http://schemas.microsoft.com/exchange/services/2006/messages" 
                  xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
    MessageDisposition="SaveOnly">
      <SavedItemFolderId>
        <t:DistinguishedFolderId Id="inbox"/>
      </SavedItemFolderId>
      <Items>
        <t:Item>
          <t:ItemClass>IPM.Note</t:ItemClass>
          <t:Subject>Create an extended property</t:Subject>
          <t:Body BodyType="Text">Added info to extended props</t:Body>
          <t:ExtendedProperty>
            <t:ExtendedFieldURI DistinguishedPropertySetId="PublicStrings" 
                                PropertyName="IsMyHouse" 
                                PropertyType="Boolean"/>
            <t:Value>true</t:Value>
          </t:ExtendedProperty>
          <t:ExtendedProperty>
            <t:ExtendedFieldURI DistinguishedPropertySetId="PublicStrings" 
                                PropertyName="HousePrices" 
                                PropertyType="CurrencyArray"/>
            <t:Values>
              <t:Value>30000000</t:Value>
              <t:Value>40000000</t:Value>
              <t:Value>50000000</t:Value>
            </t:Values>
          </t:ExtendedProperty>
        </t:Item>
      </Items>
    </CreateItem>
  </soap:Body>
</soap:Envelope>

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

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

См. также