Partager via

Référencer les propriétés par un espace de noms

  • Article

Cette rubrique répertorie les espaces de noms pris en charge par PropertyAccessor, Table et View et leurs objets enfants, et traite du référencement des propriétés nommées.

Espaces de noms utilisés par les objets Outlook

Le tableau suivant synthétise les noms d’espaces et les objets Outlook pris en charge par les espaces de noms. Notez que les références de propriétés par noms d’espaces sont sensibles à la casse.

Namespaces Objets Outlook pris en charge
https://schemas.microsoft.com/mapi/proptag Objets d’élément Outlook, AddressEntry, AddressList, Attachment, ExchangeDistributionList, ExchangeUser, Folder, Recipient et Store .
https://schemas.microsoft.com/mapi/id (Les mêmes que ci-dessus)
https://schemas.microsoft.com/mapi/string (Les mêmes que ci-dessus)
https://schemas.microsoft.com/exchange (Les mêmes que ci-dessus)
urn:schemas-microsoft-com:office:office Objets d’élément Outlook
urn:schemas-microsoft-com:office:outlook Objets d’élément Outlook
DAV: Objets d’élément Outlook
urn:schemas:calendar Objets d’élément Outlook
urn:schemas:contacts Objets d’élément Outlook
urn:schemas:httpmail Objets d’élément Outlook
urn:schemas:mailheader Objets de l’élément Outlook

Espaces de noms MAPI (Messaging Application Programming Interface)

De nombreuses propriétés prises en charge par Outlook sont des propriétés MAPI. L’objet PropertyAccessor prend en charge trois sous-espaces de noms de l’espace de noms MAPI : proptag, id et string. Chacune des sections suivantes contient une description du sous-espace de nom, une description du format pour référencer une propriété dans ce sous-espace de nom et une définition de la syntaxe telle qu’elle est exprimée dans le formulaire d'Backus-Naur augmentée (ABNF), qui est spécifié dans [RFC4234].

espace de noms proptag

Cet espace de noms est utilisé pour accéder aux propriétés de l’espace de noms MAPI à l’aide de la balise de propriété d’une propriété. Il ne prend en charge que les propriétés de la gamme de propriétés MAPI (c’est-à-dire les propriétés dotées d’un identifiant inférieur à 0x8000). Le format permettant de référencer une propriété dans cet espace de noms est le suivant :

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

HHHHHHH représente une valeur de balise de propriété hexadécimale, avec un identificateur de propriété unique dans l’ordre supérieur 16 bits et un type de propriété dans les 16 bits d’ordre inférieur. Chaque propriété MAPI doit être associée à une balise property, que la propriété soir définie par MAPI, Outlook ou un fournisseur de services. La valeur hexadécimale doit suivre le préfixe « 0x ».

Formellement, les références de propriétés de cet espace de noms peuvent être définies dans ABNF comme suit :

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

Par exemple, le code suivant représente la propriété MAPI PidTagSubject qu’Outlook expose dans son modèle objet en tant que Subject :

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

espace de noms id

Cet espace de noms est utilisé pour accéder aux propriétés d’un espace de noms identifié par l’identificateur global unique (GUID) de l’espace de noms, à l’aide de l’identificateur de la propriété . Le format permettant de référencer une propriété dans cet espace de noms est le suivant :

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

{HHHHHH-HHHH-HHHH-HHHH-HHHHHHHHHHHHHHHHH} représente le GUID de l’espace de noms, et HHHHHHHhh représente la balise de propriété.

Formellement, les références de propriétés de cet espace de noms peuvent être définies dans ABNF comme suit :

  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

Par exemple, le code suivant représente la propriété Outlook NoAging :

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

string, espace de noms

Cet espace de noms est utilisé pour accéder aux propriétés nommées sous forme de chaîne dans un espace de noms identifié. Le format permettant de référencer une propriété dans cet espace de noms est le suivant :

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

{HHHHHHH-HHHH-HHHH-HHHHHHHHHHHHHHHHHHHHH } représente le GUID de l’espace de noms, et name est le nom de propriété local défini sous forme de chaîne.

Formellement, les références de propriétés de cet espace de noms peuvent être définies dans ABNF comme suit :

  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

Voici un exemple qui utilise cet espace de noms :

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

Les règles d’échappement s’appliquent au référencement des propriétés nommées dans l’espace de noms de chaîne . Lorsque vous référencez une propriété nommée qui a un identificateur de chaîne (par exemple, Author, Company et Title), si le nom de la propriété contient un espace, un guillemet simple, un guillemet double ou un caractère de pourcentage, vous devez utiliser l’échappement URL (Universal Resource Locator) et représenter ces caractères avec la chaîne d’échappement correspondante, comme indiqué dans le tableau suivant.

Charactère figurant dans la référence de propriété Chaîne d’échappement
Espace %20
Guillemet double %22
Guillemet simple %27
Caractère de pourcentage 25 %

Voici un exemple de la façon dont vous spécifiez et obtenez la valeur d’une propriété nommée, Mom’s « Gift », définie dans l’espace de noms de chaîne MAPI, à l’aide de la méthode PropertyAccessor.GetProperty :

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

Espace de noms Exchange

L’espace de noms exchange permet d’accéder aux propriétés Exchange nommées par chaîne. Le format permettant de référencer une propriété dans cet espace de noms est le suivant :

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

name est le nom de la propriété locale définie sous la forme d’une chaîne.

Exemple de propriété référencée par cet espace de noms :

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

Espaces de noms Office

L’objet PropertyAccessor prend en charge deux espaces de noms secondaires Office :

espace de noms Office

Cet espace de noms est utilisé pour accéder aux propriétés de l’objet DocumentItem . Le format permettant de référencer une propriété dans cet espace de noms est le suivant :

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

name est le nom de la propriété locale définie sous la forme d’une chaîne.

Voici quelques exemples de référencement des propriétés DocumentItem à l’aide de l’espace de noms Office :

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

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

Espace de noms Outlook

Cet espace de noms est utilisé pour accéder aux propriétés au niveau de l’élément Outlook. À l’instar des autres espaces de noms prenant en charge le référencement des propriétés, cet espace de noms permet d’accéder aux propriétés Outlook qui ne sont pas explicitement exposées dans le modèle objet. Le format permettant de référencer une propriété dans cet espace de noms est le suivant :

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

name est le nom de la propriété locale définie sous la forme d’une chaîne.

Voici un exemple de référencement d’une propriété au niveau de l’élément Outlook à l’aide de l’espace de noms Outlook :

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

Espaces de noms DAV (Distributed Authoring and Versioning)

Les espaces de noms DAV sont utilisés pour accéder aux propriétés au niveau de l’élément Outlook. Une propriété dans un espace de noms DAV est délimitée à l’aide d’une référence d’espace de noms URI (Uniform Resource Identifier). Le format est une concaténation du préfixe de l’URI de l’espace de noms et du nom de propriété local exprimé dans une chaîne, l’URI de l’espace de noms étant soit un NOM de ressource uniforme (URN) soit un localisateur de ressources uniformes (URL).

Les espaces de noms DAV pris en charge par l’objet PropertyAccessor sont les suivants :

  • DAV:

  • urn:schemas:calendar

  • urn:schemas:contacts

  • urn:schemas:httpmail

  • urn:schemas:mailheader

Voici quelques exemples de propriétés référencées par plusieurs espaces de noms DAV :

  • DAV:checkintime

  • urn:schemas:httpmail:subject

  • urn:schemas:mailheader:subject

Voir aussi

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.