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

Ссылка на свойства по пространству имен

  • Статья

В этой статье перечислены пространства имен, поддерживаемые объектами PropertyAccessor, Table и View и их дочерними объектами, и рассматривается создание ссылок именованных свойств.

Пространства имен, используемые объектами Outlook

В таблице ниже перечислены пространства имен и объекты Outlook, поддерживаемые пространствами имен. Обратите внимание, что ссылки на свойства по пространству имен вводятся с учетом регистра.

Пространства имен Поддерживаемые объекты Outlook
https://schemas.microsoft.com/mapi/proptag Объекты элементов Outlook, объекты AddressEntry, AddressList, Attachment, ExchangeDistributionList, ExchangeUser, Folder, Recipient и Store.
https://schemas.microsoft.com/mapi/id (То же, что выше)
https://schemas.microsoft.com/mapi/string (То же, что выше)
https://schemas.microsoft.com/exchange (То же, что выше)
urn:schemas-microsoft-com:office:office Объекты элементов Outlook
urn:schemas-microsoft-com:office:outlook Объекты элементов Outlook
DAV: Объекты элементов Outlook
urn:schemas:calendar Объекты элементов Outlook
urn:schemas:contacts Объекты элементов Outlook
urn:schemas:httpmail Объекты элементов Outlook
urn:schemas:mailheader Объекты элементов Outlook

Пространства имен Messaging Application Programming Interface (MAPI)

Многие свойства, поддерживаемые Outlook, являются свойствами MAPI. Объект PropertyAccessor поддерживает три подпространства имен MAPI: proptag, id и string. В каждом из разделов ниже содержится описание подпространства имен, описание формата для ссылки на свойство в этом подпространстве имен, а также определение синтаксиса, представленное в расширенной форме Бэкуса — Наура (ABNF), которая указана в документе [RFC4234].

Пространство имен proptag

Это пространство имен используется для доступа к пространству имен MAPI с помощью тега свойства. Оно поддерживает только свойства в диапазоне свойств MAPI (т. е. свойства с идентификатором меньше 0x8000). Ниже приведен формат для ссылки на свойство в этом пространстве имен.

https://schemas.microsoft.com/mapi/proptag/0xHHHHHHHH

HHHHHHHH представляет шестнадцатеричное значение тега свойства. Уникальный идентификатор записывается в 16-битном верхнем порядке, а тип свойства — в 16-битном нижнем порядке. Все свойства MAPI должны иметь тег свойства независимо от того, определяется ли свойство с помощью MAPI, Outlook или поставщика услуг. Перед шестнадцатеричным значением должен использоваться префикс "0x".

Формально ссылки на свойства в этом пространстве имен можно определить в ABNF указанным ниже образом.

  proptag-specifier = "https://schemas.microsoft.com/mapi/proptag/x" property-id property-type 
  property-id = 4HEXDIG 
  property-type = 4HEXDIG

Например, ниже представлено свойство MAPI PidTagSubject, используемое в объектной модели Outlook в качестве свойства Subject:

https://schemas.microsoft.com/mapi/proptag/0x0037001E

Пространство имен id

Это пространство используется для доступа к свойствам в пространстве имен, определенном глобальным уникальным идентификатором (GUID) пространства имен, с помощью идентификатора свойства. Ниже приведен формат для ссылки на свойство в этом пространстве имен.

https://schemas.microsoft.com/mapi/id/{HHHHHHHH-HHHH-HHHH-HHHH-HHHHHHHHHHHH}/HHHHHHHH

{HHHHHHHH-HHHH-HHHH-HHHH-HHHHHHHHHHHH} представляет GUID пространства имен, а HHHHHHHH — тег свойства.

Формально ссылки на свойства в этом пространстве имен можно определить в ABNF указанным ниже образом.

  id-specifier = "https://schemas.microsoft.com/mapi/id/" property-set "/x" property-long-id 
property-set = "{" 8HEXDIG "-" 4HEXDIG "-" 4HEXDIG "-" 4HEXDIG "-" 12HEXDIG "}" 
property-long-id = 8HEXDIG

Например, ниже представлено свойство NoAging Outlook:

https://schemas.microsoft.com/mapi/id/{00062008-0000-0000-C000-000000000046}/850E000B

Пространство имен string

Это пространство имен используется для доступа к строковым именованным свойствам в определенном пространстве имен. Ниже приведен формат для ссылки на свойство в этом пространстве имен.

https://schemas.microsoft.com/mapi/string/{HHHHHHHH-HHHH-HHHH-HHHH-HHHHHHHHHHHH}/ name

{HHHHHHHH-HHHH-HHHH-HHHH-HHHHHHHHHHHH} представляет GUID пространства имен, а name — это локальное имя свойства, определенное в виде строки.

Формально ссылки на свойства в этом пространстве имен можно определить в ABNF указанным ниже образом.

  string-specifier = "https://schemas.microsoft.com/mapi/string/" property-set "/" property-name 
property-set = "{" 8*HEXDIG "-" 4*HEXDIG "-" 4*HEXDIG "-" 4*HEXDIG "-" 12*HEXDIG "}" 
property-name = 1*CHAR

Ниже приведен пример использования этого пространства имен.

https://schemas.microsoft.com/mapi/string/{00020386-0000-0000-C000-000000000046}/content-class

Правила пропуска применяются для ссылок на именованные свойства в пространстве имен string. При создании ссылки на именованное свойство со строковым идентификатором (например, "Автор", "Организация" или "Должность"), если имя свойства содержит пробел, одинарную кавычку, двойные кавычки или знак процента, необходимо использовать правила пропуска универсального указателя ресурсов (URL) и представлять такие символы с помощью соответствующих строк пропуска, как показано в таблице ниже.

Символ в ссылке на свойство Строка пропуска
Символ пробела %20
Двойные кавычки %22
Одинарная кавычка %27
Знак процента %25

Ниже приведен пример, как указать и получить значение именованного свойства Mom's "Gift" (Подарок мамы), определенного в пространстве имен MAPI, с помощью метода PropertyAccessor.GetProperty.

  PropertyAccessor.GetProperty("https://schemas.microsoft.com/mapi/string/{00020329-0000-0000-C000-000000000046}/Mom%27s%20%22Gift%22")

Пространство имен Exchange

Пространство имен exchange используется для доступа к строковым именованным свойствам Exchange. Ниже приведен формат для ссылки на свойство в этом пространстве имен.

https://schemas.microsoft.com/exchange/ name

name — это локальное имя свойства, определенное в виде строки.

Ниже приведен пример ссылки на свойство по этому пространству имен.

https://schemas.microsoft.com/exchange/readreceiptrequested

Пространства имен Office

Объект PropertyAccessor поддерживает два подпространства Office:

Пространство имен Office

Это пространство имен используется для доступа к свойствам объекта DocumentItem. Ниже приведен формат для ссылки на свойство в этом пространстве имен.

urn:schemas-microsoft-com:office:office# name

name — это локальное имя свойства, определенное в виде строки.

Ниже приведены некоторые примеры ссылок на свойства DocumentItem с помощью пространства имен Office.

  • urn:schemas-microsoft-com:office:office#Subject

  • urn:schemas-microsoft-com:office:office#Template

Пространство имен Outlook

Это пространство имен используется для доступа к свойствам на уровне элементов Outlook. Аналогично другим пространствам имен, поддерживающим ссылки на свойства, это пространство имен можно использовать для доступа к свойствам Outlook, которые не представлены явным образом в объектной модели. Ниже приведен формат для ссылки на свойство в этом пространстве имен.

urn:schemas-microsoft-com:office:outlook# name

name — это локальное имя свойства, определенное в виде строки.

Ниже приведен пример ссылки на свойство уровня элементов Outlook с помощью пространства имен Outlook.

urn:schemas-microsoft-com:office:outlook#remotemessagesize

Пространства имен DAV

Пространства имен DAV используются для доступа к свойствам на уровне элементов Outlook. Свойство в пространстве имен DAV ограничивается с помощью ссылки на пространство имен единого идентификатора ресурсов (URI). Этот формат является объединением префикса URI пространства имен и локального имени свойства, представленного в виде строки, где URI пространства имен — это унифицированное имя ресурса (URN) или унифицированный указатель ресурсов (URL).

Ниже представлены пространства имен DAV, поддерживаемые объектом PropertyAccessor:

  • DAV:

  • urn:schemas:calendar

  • urn:schemas:contacts

  • urn:schemas:httpmail

  • urn:schemas:mailheader

Ниже представлено несколько примеров ссылок на свойства с помощью разных пространств имен DAV:

  • DAV:checkintime

  • urn:schemas:httpmail:subject

  • urn:schemas:mailheader:subject

См. также

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.