Properties Overview
Propriedades do Outlook
Uma propriedade é um atributo de um objeto do Outlook. Properties describe something about the object, such as the sender of a message item, or the number of items in a folder. Outlook defines many properties; these are referred to as built-in properties in this documentation. The Outlook object model exposes many built-in properties with string names, such as the Subject property of a mail item.
These properties are further qualified as explicit built-in properties. Customers and service providers can extend the predefined properties of Outlook by creating new, custom properties. For example, through custom forms, customers can define properties to extend the functionality for a specific message class, and service providers can define properties to expose the unique features of their messaging system.
Pontos de entrada do modelo de objeto
The Outlook object model provides several approaches to access Outlook properties, such as:
Referencing a property directly from the parent object to access explicit built-in properties of item objects (for example, the MailItem.SenderEmailAddress property)
Using ItemProperties and ItemProperty to enumerate explicit built-in properties and custom properties and access custom properties of item objects
Using UserProperties and UserProperty to enumerate and access custom properties of item objects
Using the PropertyAccessor object to access built-in and custom properties of the following objects:
Observação
[!OBSERVAçãO] Although ItemProperties and UserProperties support enumerating explicit built-in properties, and UserProperties.Find supports searching for explicit built-in properties, use these objects primarily for custom properties of item objects. Use the PropertyAccessor object to access properties of non-item objects, or item-level properties that are not explicitly exposed in the Outlook object model.
A tabela a seguir mostra quando usar quais pontos de entrada.
| Object.Property | UserProperty, UserProperties | ItemProperty, ItemProperties | PropertyAccessor | |
|---|---|---|---|---|
| Ação sobre propriedades | Obter e definir propriedades internas explícitas dos objetos do item. | Enumerar, criar, obter, definir e remover propriedades personalizadas dos objetos do item. | Enumerar propriedades internas explícitas e propriedades personalizadas dos objetos do item; criar, obter, definir e remover propriedades personalizadas dos objetos do item. | Obter e definir propriedades internas, além de criar, obter, definir e remover propriedades personalizadas. Entre os objetos estão objetos do item, além dos seguintes: AddressEntry, AddressList, Attachment, ExchangeUser, ExchangeDistributionList, Folder, Recipient e Store. Propriedades de acesso pelos namespaces apropriados. Para obter mais informações, consulte Indicando propriedades por namespace. |
| Desempenho | Nenhuma sobrecarga de desempenho. | A enumeração e o acesso às propriedades usando UserProperties podem acarretar uma sobrecarga de desempenho. | A enumeração e o acesso às propriedades usando ItemProperties podem acarretar uma sobrecarga de desempenho. | O uso de PropertyAccessor para acessar as propriedades acarreta uma sobrecarga de desempenho. Para obter ou definir várias propriedades, use GetProperties e SetProperties em oposição a chamadas repetidas para GetProperty e SetProperty. |
Suporte e comentários
Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.