Verweisen auf Eigenschaften mithilfe von Namespaces
In diesem Thema werden die Namespaces aufgeführt, die von PropertyAccessor, Table und View und ihren untergeordneten Objekten unterstützt werden, und das Verweisen auf benannte Eigenschaften wird erläutert.
Von Outlook-Objekten verwendete Namespaces
In der folgenden Tabelle werden die Namespaces und die Outlook-Objekte zusammengefasst, die von den Namespaces unterstützt werden. Beachten Sie, dass bei Eigenschaftsverweisen mithilfe von Namespaces Groß-/Kleinschreibung beachtet wird.
Namespaces | Unterstützte Outlook-Objekte |
---|---|
https://schemas.microsoft.com/mapi/proptag | Outlook-Elementobjekte, AddressEntry-, AddressList-, Attachment-, ExchangeDistributionList-, ExchangeUser-, Folder-, Recipient- und Store-Objekte . |
https://schemas.microsoft.com/mapi/id | (Wie oben) |
https://schemas.microsoft.com/mapi/string | (Wie oben) |
https://schemas.microsoft.com/exchange | (Wie oben) |
urn:schemas-microsoft-com:office:office | Outlook-Elementobjekte |
urn:schemas-microsoft-com:office:outlook | Outlook-Elementobjekte |
DAV: | Outlook-Elementobjekte |
urn:schemas:calendar | Outlook-Elementobjekte |
urn:schemas:contacts | Outlook-Elementobjekte |
urn:schemas:httpmail | Outlook-Elementobjekte |
urn:schemas:mailheader | Outlook-Element-Objekte |
MAPI-Namespaces (Messaging Application Programming Interface)
Many properties that Outlook supports are MAPI properties. Das PropertyAccessor-Objekt unterstützt drei Unternamespaces des MAPI-Namespaces: proptag, id und string. Each of the following sections contains a description for the subnamespace, a description for the format to reference a property in that subnamespace, and a definition of the syntax as expressed in Augmented Backus-Naur Form (ABNF), that is specified in [RFC4234].
proptag-Namespace
Dieser Namespace wird verwendet, um mithilfe des Eigenschaftentags einer Eigenschaft auf Eigenschaften im MAPI-Namespace zuzugreifen. Er unterstützt nur Eigenschaften im MAPI-Eigenschaftsbereich (d. h. Eigenschaften mit einem Eigenschaftsbezeichner unter 0x8000). Das Format zum Verweisen auf eine Eigenschaft in diesem Namespace lautet:
https://schemas.microsoft.com/mapi/proptag/0xHHHHHHHH
HHHHHHHHHHHHH stellt einen hexadezimalen Eigenschaftstagwert mit einem eindeutigen Eigenschaftsbezeichner in den höheren 16 Bits und einem Eigenschaftstyp in der niedrigeren 16 Bit-Reihenfolge dar. Jede MAPI-Eigenschaft muss über ein Eigenschaftstag verfügen, ungeachtet dessen, ob die Eigenschaft durch MAPI, Outlook oder einen Dienstanbieter definiert wird. Der Hexadezimalwert muss auf das Präfix "0x" folgen.
Formal können Verweise auf Eigenschaften in diesem Namespace in ABNF wie folgt definiert werden:
proptag-specifier = "https://schemas.microsoft.com/mapi/proptag/x" property-id property-type
property-id = 4HEXDIG
property-type = 4HEXDIG
Das folgende Beispiel stellt die MAPI-Eigenschaft PidTagSubject dar, die Outlook im Objektmodell als Subject verfügbar macht:
https://schemas.microsoft.com/mapi/proptag/0x0037001E
ID-Namespace
Dieser Namespace wird verwendet, um mithilfe des Bezeichners der Eigenschaft auf Eigenschaften in einem Namespace zuzugreifen, der durch den GUID (Globally Unique Identifier) des Namespace identifiziert wird. Das Format zum Verweisen auf eine Eigenschaft in diesem Namespace lautet:
https://schemas.microsoft.com/mapi/id/{HHHHHHHH-HHHH-HHHH-HHHH-HHHHHHHHHHHH}/HHHHHHHH
{HHHHHHHHH-HHHHH-HHHHH-HHHHHHHHHHHHHH } stellt die Namespace-GUID dar, und HHHHHHHH stellt das Eigenschaftstag dar.
Formal können Verweise auf Eigenschaften in diesem Namespace in ABNF wie folgt definiert werden:
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
Das folgende Beispiel stellt die Outlook NoAging-Eigenschaft dar:
https://schemas.microsoft.com/mapi/id/{00062008-0000-0000-C000-000000000046}/850E000B
Zeichenfolgennamespace
Dieser Namespace wird für den Zugriff auf eigenschaften mit Zeichenfolgennamen in einem identifizierten Namespace verwendet. Das Format zum Verweisen auf eine Eigenschaft in diesem Namespace lautet:
https://schemas.microsoft.com/mapi/string/{HHHHHHHH-HHHH-HHHH-HHHH-HHHHHHHHHHHH}/ name
{HHHHHHHHH-HHHH-HHHHH-HHHHHHHHHHHHHHH} stellt die Namespace-GUID dar, und name ist der lokale Eigenschaftsname, der als Zeichenfolge definiert ist.
Formal können Verweise auf Eigenschaften in diesem Namespace in ABNF wie folgt definiert werden:
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
Im folgenden Beispiel wird dieser Namespace verwendet:
https://schemas.microsoft.com/mapi/string/{00020386-0000-0000-C000-000000000046}/content-class
Escaperegeln gelten für den Verweis auf benannte Eigenschaften im Zeichenfolgennamespace . Wenn sie auf eine benannte Eigenschaft verweisen, die über einen Zeichenfolgenbezeichner (z. B. Autor, Unternehmen und Titel) verfügt, müssen Sie, wenn der Eigenschaftenname ein Leerzeichen, ein einfaches Anführungszeichen, ein doppeltes Anführungszeichen oder ein Prozentzeichen enthält, ein Escapezeichen verwenden und diese Zeichen mit der entsprechenden Escapezeichenfolge darstellen, wie in der folgenden Tabelle dargestellt.
Zeichen im Eigenschaftenverweis | Escapezeichenfolge |
---|---|
Leerzeichen | %20 |
Doppeltes Anführungszeichen | %22 |
Einfaches Anführungszeichen | %27 |
Prozentzeichen | 25 % |
Im Folgenden finden Sie ein Beispiel dafür, wie Sie mithilfe der PropertyAccessor.GetProperty-Methode den Wert einer benannten Eigenschaft angeben und abrufen, Moms "Gift", die im MAPI-Zeichenfolgennamespace definiert ist:
PropertyAccessor.GetProperty("https://schemas.microsoft.com/mapi/string/{00020329-0000-0000-C000-000000000046}/Mom%27s%20%22Gift%22")
Exchange-Namespace
Der Exchange-Namespace wird verwendet, um auf Exchange-Eigenschaften mit Zeichenfolgennamen zuzugreifen. Das Format zum Verweisen auf eine Eigenschaft in diesem Namespace lautet:
https://schemas.microsoft.com/exchange/ name
name ist der lokale Eigenschaftsname, der als Zeichenfolge definiert ist.
Im folgenden Beispiel wird durch diesen Namespace auf eine Eigenschaft verwiesen:
https://schemas.microsoft.com/exchange/readreceiptrequested
Office-Namespaces
Das PropertyAccessor-Objekt unterstützt zwei untergeordnete Office-Namespaces:
Office-Namespace
Dieser Namespace wird für den Zugriff auf Eigenschaften des DocumentItem-Objekts verwendet. Das Format zum Verweisen auf eine Eigenschaft in diesem Namespace lautet:
urn:schemas-microsoft-com:office:office# -Name
name ist der lokale Eigenschaftsname, der als Zeichenfolge definiert ist.
Im Folgenden finden Sie einige Beispiele für den Verweis auf DocumentItem-Eigenschaften mithilfe des Office-Namespace:
urn:schemas-microsoft-com:office:office#Subject
urn:schemas-microsoft-com:office:office#Template
Outlook-Namespace
Dieser Namespace wird für den Zugriff auf Outlook-Eigenschaften auf Elementebene verwendet. Ähnlich wie bei anderen Namespaces, die Eigenschaftsverweise unterstützen, verwenden Sie diesen Namespace, um auf Outlook-Eigenschaften zuzugreifen, die im Objektmodell nicht explizit verfügbar gemacht werden. Das Format zum Verweisen auf eine Eigenschaft in diesem Namespace lautet:
urn:schemas-microsoft-com:office:outlook# name
name ist der lokale Eigenschaftsname, der als Zeichenfolge definiert ist.
Im Folgenden finden Sie ein Beispiel für den Verweis auf eine Outlook-Eigenschaft auf Elementebene mithilfe des Outlook-Namespace:
urn:schemas-microsoft-com:office:outlook#remotemessagesize
DAV-Namespaces (Distributed Authoring and Versioning)
DAV-Namespaces werden verwendet, um auf Outlook-Eigenschaften auf Elementebene zuzugreifen. Eine Eigenschaft in einem DAV-Namespace wird mithilfe eines URL-Namespaceverweises (Uniform Resource Identifier) zugeordnet. Das Format ist eine Verkettung des URI-Präfixes des Namespaces und des in einer Zeichenfolge ausgedrückten lokalen Eigenschaftsnamens, wobei der Namespace-URI ein URN (Uniform Resource Name) oder eine URL (Uniform Resource Locator) ist.
Die folgenden DAV-Namespaces werden vom PropertyAccessor-Objekt unterstützt:
DAV:
urn:schemas:calendar
urn:schemas:contacts
urn:schemas:httpmail
urn:schemas:mailheader
Beispiele für Eigenschaften, auf die durch verschiedene DAV-Namespaces verwiesen wird:
DAV:checkintime
urn:schemas:httpmail:subject
urn:schemas:mailheader:subject
Siehe auch
- MAPI-Eigenschaftstags
- Übersicht über MAPI-Eigenschaftsbezeichner
- Übersicht über MAPI-Eigenschaftentypen
- Eigenschaftsbezeichnerbereiche
- Eigenschaftentypen
- Benannte Eigenschaften MAPI
Support und Feedback
Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.