_Columns.Add(String) Метод

Определение

Пространство имен:

Microsoft.Office.Interop.Outlook

Сборка:

Microsoft.Office.Interop.Outlook.dll

Добавляет объект , заданный Column параметром Name , в коллекцию Columns и сбрасывает 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

Параметры

Name

String

Имя свойства, добавляемого в виде столбца.

Возвращаемое значение

Column

Объект Column , представляющий новый столбец.

Комментарии

Columns.Add добавляет указанный столбец в конец коллекции Columns для таблицы и сбрасывает таблицу , перемещая текущую строку непосредственно перед первой строкой таблицы. Если Columns.Add возвращает ошибку, текущую строку не изменится.

Name может быть явным встроенным именем свойства или именем свойства, на которое ссылается пространство имен. На него необходимо ссылаться в качестве имени в английском языковом стандарте. Дополнительные сведения о ссылках на свойства по пространству имен см. в разделе Ссылки на свойства по пространству имен.

При добавлении свойства, которое является явным встроенным свойством в объектной модели, например , FirstNameнеобходимо указать Name в качестве явного встроенного имени свойства на английском языке. Для некоторых типов свойств формат, используемый при добавлении этих свойств в качестве столбцов, влияет на то, как их значения выражаются в таблице. Дополнительные сведения о представлении значения свойства в таблице см. в разделе Факторы, влияющие на представление значения свойства в классах таблицы и представления.

При добавлении настраиваемого свойства в таблицу со ссылкой на свойство по пространству имен строки MAPI необходимо явно добавить тип свойства в конец ссылки на свойство. Например, чтобы добавить пользовательское свойство MyCustomProperty, которое содержит строку Юникода, необходимо явно добавить тип 001f к ссылке, в http://schemas.microsoft.com/mapi/string/{HHHHHHHH-HHHH-HHHH-HHHH-HHHHHHHHHHHH}/MyCustomProperty/0x0000001fрезультате чего: , где {HHHHHHH-HHHH-HHHH-HHHH-HHHH-HHHHHHHHHHHHHHHHH} представляет GUID пространства имен.

Некоторые свойства нельзя добавить в таблицу с помощью Columns.Add, включая двоичные свойства, вычисляемые свойства и содержимое текста HTML или RTF. Дополнительные сведения см. в разделе Неподдерживаемые свойства в объекте таблицы или фильтре таблицы.

Хотя SetColumns(String) можно использовать для упрощения кэширования определенных свойств для чрезвычайно быстрого доступа к этим свойствам Items коллекции, некоторые свойства ограничены setColumns. Так как эти ограничения не применяются к Columns.Add, объект Table является менее ограничительной альтернативой, чем Items.