_Columns.Add(String) Méthode

Référence

Définition

Espace de noms:: Microsoft.Office.Interop.Outlook

Assembly:: Microsoft.Office.Interop.Outlook.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Ajoute le Column spécifié par Name à la Columns collection et réinitialise le Table.

public:
 Microsoft::Office::Interop::Outlook::Column ^ Add(System::String ^ Name);

public Microsoft.Office.Interop.Outlook.Column Add (string Name);

Public Function Add (Name As String) As Column

Paramètres

Name: String

Nom de la propriété qui est ajoutée en tant que colonne.

Retours

Column

Un objet Column qui représente la nouvelle colonne.

Remarques

Columns.Add ajoute l'objet Column spécifié à la fin de la collection Columns pour l'objet Table et réinitialise l'objet Table en déplaçant la ligne active immédiatement avant la première ligne de l'objet Table. Si la méthode Columns.Add renvoie une erreur, la position de la ligne active n'est pas changée.

Name peut être un nom de propriété intégré explicite ou un nom de propriété référencé par un espace de noms. Il doit être référencé en tant que nom dans les paramètres régionaux Anglais. Pour plus d’informations sur le référencement des propriétés par espace de noms, consultez Référencement des propriétés par espace de noms

Si vous ajoutez une propriété qui est une propriété intégrée explicite dans le modèle objet, par exemple, FirstName, vous devez spécifier Name comme nom de propriété intégrée explicite en anglais. Le format utilisé pour certains types de propriétés qui sont ajoutées en tant que colonnes a une incidence sur la manière dont les valeurs de ces propriétés sont exprimées dans l’objet Table. Pour plus d’informations sur la représentation des valeurs de propriété dans une table, consultez Facteurs affectant la représentation de la valeur de propriété dans les classes Table et Vue

Si vous ajoutez une propriété personnalisée à un objet Table, référençant celle-ci par l'espace de noms MAPI, vous devez explicitement ajouter le type de la propriété à la fin de la référence. Par exemple, pour ajouter la propriété personnalisée MyCustomProperty, qui a la chaîne Unicode de type, vous devez ajouter explicitement le type 001f à la référence, ce qui aboutit à : http://schemas.microsoft.com/mapi/string/{HHHHHHHH-HHHH-HHHH-HHHH-HHHHHHHHHHHH}/MyCustomProperty/0x0000001f, où {HHHHHH-HHHH-HHHH-HHHH-HHHHHHHHHHHHHHHHHHHHHH} représente le GUID de l’espace de noms.

Certaines propriétés ne peuvent pas être ajoutées à un objet Table à l’aide de Columns.Add, notamment les propriétés binaires, les propriétés calculées, ainsi que le contenu du corps HTML ou RTF. Pour plus d’informations, consultez Propriétés non prises en charge dans un objet Table ou Filtre de table

Bien que SetColumns(String) peut être utilisé pour faciliter la mise en cache de certaines propriétés pour un accès extrêmement rapide à ces propriétés d’une Items collection, certaines propriétés sont limitées à partir de SetColumns. Étant donné que cette restriction ne s’applique pas à Columns.Add, l’utilisation de l’objet Table est moins restrictive que celle de l’objet Items.

S’applique à

Partager via