Ссылка на свойства по пространству имен
В этой статье перечислены пространства имен, поддерживаемые объектами 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
См. также
- Теги свойств MAPI
- Обзор идентификаторов свойств MAPI
- Обзор типов свойств MAPI
- Диапазоны идентификаторов свойств
- Типы свойств
- Именованные свойства MAPI
Поддержка и обратная связь
Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по