_Columns.Add(String) Método

Definição

Namespace:

Microsoft.Office.Interop.Outlook

Assembly:

Microsoft.Office.Interop.Outlook.dll

Adiciona o Column especificado pela NameColumns coleção e redefine o 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

Parâmetros

Name

String

O nome da propriedade que está sendo adicionada como uma coluna.

Retornos

Column

Um objeto Column que representa a nova coluna.

Comentários

Columns. Add adiciona a coluna especificada até o final da coleção Columns para a tabela e redefine a tabela movendo a linha atual para imediatamente antes da primeira linha da tabela. Se Columns. Add retornará um erro, não alterará a linha atual.

Name pode ser um nome de propriedade interno explícito ou um nome de propriedade referenciado pelo namespace. Ele deve ser referenciado como o nome na localidade em inglês. Para obter mais informações sobre como referenciar propriedades por namespace, consulte Referencing Properties by Namespace

Se você estiver adicionando uma propriedade que é uma propriedade interna explícita no modelo de objeto, por exemplo, FirstName, você deve especificar Name como o nome da propriedade interna explícita em inglês. Para determinados tipos de propriedades, o formato usado quando adicionar essas propriedades como colunas afeta como seus valores são expressos na tabela. Para obter mais informações sobre a representação do valor da propriedade em uma Tabela, consulte Fatores que afetam a representação do valor da propriedade nas classes Tabela e Exibição

Se você estiver adicionando uma propriedade personalizada a uma tabela, fazer referência à propriedade pelo namespace da cadeia de caracteres MAPI, você precisará acrescentar explicitamente o tipo da propriedade até o final da referência de propriedade. Por exemplo, para adicionar a propriedade personalizada MyCustomProperty, que tem o tipo cadeia de caracteres Unicode, você terá que acrescentar explicitamente o tipo 001f à referência, resultando em: http://schemas.microsoft.com/mapi/string/{HHHHHHHH-HHHH-HHHH-HHHH-HHHHHHHHHHHH}/MyCustomProperty/0x0000001f, em que {HHHHHHHHHHH-HHHH-HHHHH-HHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHH

Determinadas propriedades não podem ser adicionadas a uma tabela usando Columns. Add, incluindo propriedades binárias, propriedades computadas e conteúdo do corpo HTML ou RTF. Para obter mais informações, consulte Propriedades sem suporte em um objeto de tabela ou filtro de tabela

Embora SetColumns(String) possa ser usado para facilitar o cache de determinadas propriedades para acesso extremamente rápido a essas propriedades de uma Items coleção, algumas propriedades são restritas de SetColumns. Desde que essas restrições não se aplicam ao Columns. Add, o objeto Table é uma alternativa menos restritiva que itens.