_Columns.Add(String) Método

Definición

Espacio de nombres:

Microsoft.Office.Interop.Outlook

Ensamblado:

Microsoft.Office.Interop.Outlook.dll

Agrega el Column objeto especificado por Name a la Columns colección y restablece .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

Nombre de la propiedad agregada como columna.

Devoluciones

Column

Un objeto Column que representa la nueva columna.

Comentarios

Columns.Add agrega la columna de especificada hasta el final de la colección de columnas de la tabla y restablece la tabla moviendo la fila actual justo antes de la primera fila de la tabla. Si Columns.Add devuelve un error, no cambiará la fila actual.

Name puede ser un nombre de propiedad integrado explícito o un nombre de propiedad al que hace referencia el espacio de nombres. Se le debe hacer referencia en la configuración regional del inglés. Para obtener más información sobre cómo hacer referencia a propiedades por espacio de nombres, vea Hacer referencia a propiedades por espacio de nombres.

Si va a agregar una propiedad que es una propiedad integrada explícita en el modelo de objetos, por ejemplo, FirstName, debe especificar Name como el nombre de propiedad integrado explícito en inglés. Para algunos tipos de propiedades, el formato utilizado a agregar estas propiedades como columnas afecta al modo en que se expresan sus valores en la tabla. Para obtener más información sobre la representación del valor de propiedad en una tabla, vea Factores que afectan a la representación del valor de propiedad en las clases Table y View

Si va a agregar una propiedad personalizada a una tabla, hacer referencia a la propiedad el espacio de nombres de cadena MAPI, deberá anexar explícitamente el tipo de la propiedad hasta el final de la referencia de propiedad. Por ejemplo, para agregar la propiedad personalizada MyCustomProperty, que tiene el tipo cadena Unicode, tendrá que anexar explícitamente el tipo 001f a la referencia, lo que da como resultado: http://schemas.microsoft.com/mapi/string/{HHHHHHHH-HHHH-HHHH-HHHH-HHHHHHHHHHHH}/MyCustomProperty/0x0000001f, donde {HHHHHHHH-HHHH-HHHH-HHHH-HHHHHHHHHHHH} representa el GUID del espacio de nombres.

Algunas propiedades no se puede agregar a una tabla usando Columns.Add, incluido las propiedades binarias, propiedades calculadas y contenido HTML o RTF. Para obtener más información, vea Propiedades no admitidas en un objeto Table o filtro de tabla.

Aunque SetColumns(String) se puede usar para facilitar el almacenamiento en caché de ciertas propiedades para un acceso extremadamente rápido a esas propiedades de una Items colección, algunas propiedades están restringidas a SetColumns. Dado que estas restricciones no se aplican a Columns.Add, el objeto Table es una alternativa menos restrictiva que Items.