Прочитать на английском

Поделиться через


Объект Row (Outlook)

Представляет строку данных в объекте Table .

Замечания

Таблица состоит из строк и столбцов. Он представляет динамический набор строк только для чтения в объекте Folder или Search . Каждую строку таблицы можно рассматривать как элемент в папке, а каждый столбец — как свойство элемента. По умолчанию таблица содержит только подмножество свойств для элементов в папке. Это делает таблицу упрощенным набором строк в памяти, который поддерживает быстрое перечисление и фильтрацию элементов в папке.

Если объект Table получен из Folder.GetTable, можно дополнительно указать фильтр (в Table.Restrict), чтобы получить более ограниченный набор строк в таблице.

Используйте методы Table: FindRow, FindNextRow, GetNextRow и MoveToStart , чтобы получить определенную строку в таблице.

Используйте Row.GetValues , чтобы получить массив значений, соответствующих значениям столбца в этой строке таблицы.

Используйте вспомогательные функции Row.BinaryToString, Row.LocalTimeToUTC и Row.UTCToLocalTime для упрощения преобразования типов значений столбцов в определенной строке. Дополнительные сведения о представлении значения свойства в таблице см. в разделе Факторы, влияющие на представление значения свойства в классах таблицы и представления.

Хотя добавление и удаление базовой папки отражаются строками в таблице, таблица не поддерживает никаких событий для добавления, изменения и удаления строк. Если требуется записываемый объект из строки Table , получите идентификатор записи для этой строки из столбца EntryID по умолчанию в таблице , а затем используйте метод GetItemFromID объекта NameSpace , чтобы получить полный элемент, например MailItem или ContactItem, поддерживающий операции чтения и записи. Дополнительные сведения о столбцах по умолчанию в таблице см. в разделе Свойства по умолчанию, отображаемые в объекте таблицы.

Пример

В следующем примере кода показано, как получить объект Table на основе LastModificationTime элементов в папке "Входящие". Здесь также показано, как настраивать столбцы в таблице, а также как перечислять и выводить значения соответствующих свойств этих элементов.

Sub DemoTable() 
 
 'Declarations 
 
 Dim Filter As String 
 
 Dim oRow As Outlook.Row 
 
 Dim oTable As Outlook.Table 
 
 Dim oFolder As Outlook.Folder 
 
 
 
 'Get a Folder object for the Inbox 
 
 Set oFolder = Application.Session.GetDefaultFolder(olFolderInbox) 
 
 
 
 'Define Filter to obtain items last modified after May 1, 2005 
 
 Filter = "[LastModificationTime] > '5/1/2005'" 
 
 'Restrict with Filter 
 
 Set oTable = oFolder.GetTable(Filter) 
 
 
 
 'Remove all columns in the default column set 
 
 oTable.Columns.RemoveAll 
 
 'Specify desired properties 
 
 With oTable.Columns 
 
 .Add ("Subject") 
 
 .Add ("LastModificationTime") 
 
 'PR_ATTR_HIDDEN referenced by the MAPI proptag namespace 
 
 .Add ("http://schemas.microsoft.com/mapi/proptag/0x10F4000B") 
 
 End With 
 
 
 
 'Enumerate the table using test for EndOfTable 
 
 Do Until (oTable.EndOfTable) 
 
 Set oRow = oTable.GetNextRow() 
 
 Debug.Print (oRow("Subject")) 
 
 Debug.Print (oRow("LastModificationTime")) 
 
 Debug.Print (oRow("http://schemas.microsoft.com/mapi/proptag/0x10F4000B")) 
 
 Loop 
 
End Sub

Методы

Свойства

См. также

Справочник по объектной модели Outlook

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.