_Columns.Add(String) Méthode

Définition

Ajoute le Column spécifié par Name pour 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.

Namepeut être un nom de propriété intégrée explicite ou un nom de propriété référencée par un espace de noms. Il doit être référencé en tant que le nom dans les paramètres régionaux anglais. Pour plus d’informations sur les propriétés référencées par un espace de noms, voir Référencer les propriétés par Namespace

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. Pour certains types de propriétés, le format utilisé lors de l’ajout de ces propriétés en tant que colonnes affecte la manière dont leurs valeurs sont exprimées dans le tableau. Pour plus d’informations sur la représentation des valeurs de propriété dans une Table, voir Facteurs affectant la représentation des valeurs de propriété dans les Classes Table et View

Si vous ajoutez une propriété personnalisée à un tableau, faisant référence à la propriété par l’espace de noms MAPI, vous devez ajouter explicitement le type de la propriété à la fin de la référence. Par exemple, pour ajouter la propriété personnalisée MyCustomProperty, qui est de type chaîne Unicode, vous devez ajouter explicitement le type 001f à la référence, entraînant : http://schemas.microsoft.com/mapi/string/{HHHHHHHH-HHHH-HHHH-HHHH-HHHHHHHHHHHH}/MyCustomProperty/0x0000001f, où {HHHHHHHH-HHHH-HHHH-HHHH-HHHHHHHHHHHH} représente le GUID de l’espace de noms .

Certaines propriétés ne peut pas être ajoutées à un tableau à l’aide de Columns.Add, y compris les propriétés binaires, les propriétés calculées et le contenu HTML ou RTF. Pour plus d’informations, voir Propriétés non prises en charge dans un objet Table ou un filtre Table

Alors que SetColumns(String) peut être utilisé pour faciliter la mise en cache certaines propriétés pour accéder rapidement aux propriétés d’un Items collection, certaines propriétés sont limitées à partir de la méthode SetColumns. Étant donné que ces restrictions ne s’appliquent pas à Columns.Add, l’objet Table est moins restrictive que les éléments.

S’applique à