Getting the Value of a Property

Outlook propose plusieurs façons d’obtenir la valeur d’une propriété.

Object.Property UserProperty.Value ItemProperty.Value PropertyAccessor.GetProperty PropertyAccessor.GetProperties
Action Extrait la valeur de la propriété intégrée explicite. Obtient la valeur de la propriété de niveau élément personnalisée spécifiée. Aucune action n'a lieu si la propriété n'existe pas. Obtient la valeur de la propriété intégrée ou personnalisée spécifiée au niveau de l’élément, à condition que la propriété ne soit pas une propriété bloquée. Aucune action n'a lieu si la propriété n'existe pas. Obtient un objet qui représente la valeur de la propriété spécifiée par SchemaName, à condition que la propriété ne soit pas une propriété bloquée. Renvoie une erreur si la propriété n'existe pas. Pour chaque propriété de SchemaNames, sous réserve que la propriété ne soit pas une propriété bloquée, extrait la valeur de la propriété dans un élément correspondant du tableau de variantes. Renvoie le tableau de variantes avec les valeurs de propriété lorsque PropertyAccessor.GetProperties obtient la valeur de toutes les propriétés de SchemaNames. Retourne des erreurs dans le tableau dans le cas contraire.
Objets applicables Tous les objets du modèle d'objet Outlook. Tous les objets d’élément Outlook , y compris les éléments de document Office (objets DocumentItem ). Tous les objets d’élément Outlook, y compris les éléments de document Office (objets DocumentItem ). Utilisez ItemProperty pour obtenir des propriétés intégrées explicites au niveau de l’élément. Utilisez PropertyAccessor.GetProperty pour les propriétés au niveau de l’élément sans noms explicites, propriétés personnalisées ou propriétés de l’un des objets suivants : AddressEntry, AddressList, Attachment, ExchangeDistributionList, ExchangeUser, Folder, Recipient et Store. Mêmes objets que ceux figurant dans la colonne GetProperty.
Prise en charge du type de propriété Selon les indications dans le modèle d'objet Outlook. Renvoie un objet Variant. Renvoie un objet Variant. Le type de l’objet retourné est identique au type de la propriété spécifiée par SchemaName. Si vous avez besoin d’une conversion du type de propriété brute en chaîne (pour PT_BINARY dans MAPI) ou en heure locale (PT_SYSTIME), utilisez les méthodes d’assistance PropertyAccessor.UTCToLocalTime ou PropertyAccessor.BinaryToString. PropertyAccessor ne prend pas en charge certains types de propriétés MAPI, par exemple, PT_OBJECT, et toute tentative d’obtention de la valeur des propriétés de ces types renvoie une erreur « Opération de propriété non prise en charge ». La prise en charge du type de propriété est identique à celle figurant dans la colonne GetProperty car le type de chaque valeur doit être identique au type de la propriété correspondante dans SchemaNames. Toute erreur de discordance de type est renvoyée dans le tableau qui en résulte.
Sécurité Sur un ordinateur client exécutant Microsoft Office Outlook 2007 ou version ultérieure sans logiciel antivirus approprié, toute tentative d’accès à des propriétés protégées par du code non approuvé entraîne, par défaut, l’affichage de l’avertissement de sécurité du carnet d’adresses. Le code approuvé et non approuvé peut utiliser l’objet UserProperty . Sur un ordinateur client exécutant Office Outlook 2007 ou version ultérieure sans logiciel antivirus approprié, toute tentative d’utilisation de la propriété UserProperty pour accéder à une propriété protégée par du code non approuvé entraîne, par défaut, l’affichage de l’avertissement de sécurité du carnet d’adresses. Le code approuvé et non approuvé peut utiliser l’objet ItemProperty . Sur un ordinateur client exécutant Office Outlook 2007 ou version ultérieure sans logiciel antivirus approprié, toute tentative d’utilisation de la propriété ItemProperty pour accéder à une propriété protégée par du code non approuvé entraîne, par défaut, l’affichage de l’avertissement de sécurité du carnet d’adresses. Sur un ordinateur client sans logiciel antivirus correctement configuré, le code non approuvé qui tente d’accéder à la propriété PropertyAccessor d’un objet d’élément appelle par défaut l’avertissement de sécurité du carnet d’adresses. Mêmes considérations de sécurité que celles figurant dans la colonne GetProperty.
Performances Aucun impact négatif sur les performances. Utilisez cet objet chaque fois que la propriété est une propriété intégrée explicite. Aucun impact négatif sur les performances. Utilisez cet objet chaque fois que la propriété est une propriété personnalisée de niveau d'élément. Aucun impact négatif sur les performances. Utilisez cet objet chaque fois que la propriété est une propriété de niveau d'élément personnalisée. L'utilisation de PropertyAccessor pour accéder aux propriétés entraîne une surcharge de performance. Pour définir plusieurs propriétés, utilisez PropertyAccessor.GetProperties au lieu d'utiliser plusieurs fois PropertyAccessor.GetProperty. L'utilisation de PropertyAccessor pour accéder aux propriétés entraîne une surcharge de performance. Pour extraire plusieurs propriétés, utilisez GetProperties au lieu d'utiliser plusieurs fois GetProperty.

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.