依命名空間參照屬性
本主題列出 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 項目物件 |
訊息應用程式發展介面 (MAPI) 命名空間
Outlook 支援的許多屬性為 MAPI 屬性 PropertyAccessor 物件支援三種 MAPI 命名空間的子命名空間:proptag、識別碼和字串。 下列各節包含子命名空間的描述 subnamespace、子命名空間內格式可參照屬性的描述,和在擴充巴科斯諾爾形式 (ABNF) 裡表達的語法定義,該形式在 [RFC4234] 中被指定。
proptag 命名空間
這個命名空間用來存取使用屬性之 [屬性] 標籤的 MAPI 命名空間中的內容。 只支援 MAPI 屬性範圍內的屬性 (也就是具有 0x8000 以下屬性識別項的屬性)。 下列是由此命名空間參照之屬性的格式:
https://schemas.microsoft.com/mapi/proptag/0xHHHHHHHH
HHHHHHHH 代表十六進位屬性標記值,有順序較高的 16 位元唯一屬性識別項與順序較低的 16 位元內容類型。 無論屬性是由 MAPI、Outlook 或服務提供者所定義,每個 MAPI 屬性必須有屬性標記。 十六進位值的開頭必須是 0x。
正式說來,這個命名空間中的參照屬性可以在 ABNF 定義為以下所示:
proptag-specifier = "https://schemas.microsoft.com/mapi/proptag/x" property-id property-type
property-id = 4HEXDIG
property-type = 4HEXDIG
比方說,下列代表 Outlook 在其物件模型中公開做為 主旨 的 MAPI 屬性 PidTagSubject:
https://schemas.microsoft.com/mapi/proptag/0x0037001E
識別碼命名空間
此命名空間用來存取全域唯一識別碼 (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
比方說,下列代表 Outlook 的 NoAging 屬性:
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 |
如何使用 PropertyAccessor.GetProperty 方法來指定並取得在 MAPI 字串命名空間中已定義的具名屬性媽媽的「禮物」的值,可看以下範例:
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 是定義為字串的本機屬性名稱。
以下幾個例子使用 Office 命名空間的參照DocumentItem 屬性:
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 前置詞與字串格式的區域屬性名稱,以及做為統一資源名稱 (URN) 或統一資源定位器 (URL) 的命名空間 URI。
下列是 PropertyAccessor 物件所支援的 DAV 命名空間:
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 支援與意見反應。