Метод Folder.GetTable (Outlook)

Статья
04/07/2023

Получает объект Table, содержащий элементы, отфильтрованные по фильтру.

Синтаксис

выражение. GetTable( _Filter_ , _TableContents_ )

Выражение Переменная, представляющая объект Folder.

Параметры

Имя	Обязательный или необязательный	Тип данных	Описание
Фильтр	Необязательный	String	Фильтр в синтаксисе поиска и поиска (DASL) Microsoft Jet или DAV, указывающий критерии для элементов в родительской папке.
TableContents	Необязательный	OlTableContents	Указывает тип элементов в папке, возвращаемой Командой GetTable . Значение по умолчанию — olUserItems.

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

Таблица, содержащая элементы в родительской папке, соответствующие условиям фильтра. По умолчанию TableContents является olUserItems , а возвращаемая таблица содержит только отфильтрованные элементы, которые не скрыты.

Замечания

Если параметр Filter является пустой строкой или параметр Filter опущен, GetTable возвращает таблицу со строками, представляющими все элементы в папке. Если параметр Filter является пустой строкой или параметр Filter опущен, а TableContents — olHiddenItems, GetTable возвращает таблицу со строками, представляющими все скрытые элементы в папке.

Дополнительные сведения о фильтрах см. в статьях Фильтрация элементов и Ссылка на свойства по пространству имен.

GetTable возвращает таблицу со столбцом по умолчанию, заданным для типа папки родительской папки. Чтобы изменить набор столбцов по умолчанию, используйте методы Add, Remove или RemoveAll объекта коллекции Columns . Если tableContents имеет значение olHiddenItems, набор столбцов по умолчанию всегда является столбцом по умолчанию для почтовой папки, даже если родительской папкой может быть, например, папка Контактов. Дополнительные сведения о наборах столбцов по умолчанию см. в разделе Свойства по умолчанию, отображаемые в объекте table.

Используйте Table.Restrict , чтобы применить последующие фильтры к таблице , основанной на объекте Folder .

Пример

В следующем примере кода показано, как с помощью Folder.GetTable получить объект 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)  
  
    'Enumerate the table using test for EndOfTable  
    Do Until (oTable.EndOfTable)  
        Set oRow = oTable.GetNextRow()  
        Debug.Print (oRow("Subject"))  
        Debug.Print (oRow("LastModificationTime"))  
    Loop  
End Sub

См. также

Folder Object

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

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

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