Outlook) (Folder.GetTable 方法

取得包含 Filter 所篩選項目的資料表物件。

語法

expression。 GetTable( _Filter_ , _TableContents_ )

運算式 代表 'Folder' 物件的變數。

參數

名稱 必要/選用 資料類型 描述
Filter 選用 字串 Microsoft Jet 或 DAV 搜尋和尋找 (DASL) 語法中的篩選,可指定父 資料夾中項目的準則。
TableContents 選用 OlTableContents 會指定 GetTable 所傳回資料夾中的項目類型。 預設值為 olUserItems。

傳回值

Table,其中包含上層 Folder 中,符合 Filter 中準則的項目。 根據預設,TableContents 為 olUserItems,而且傳回的 Table 僅包含非隱藏的已篩選項目。

註解

如果 Filter 是空白字串或省略 Filter 參數,GetTable 就會傳回 Table,其中各列表示 Folder 中的所有項目。 如果 Filter 是空白字串或省略 Filter 參數,而且 TableContents 為 olHiddenItems,GetTable 便會傳回 Table,其中各列表示 Folder 中的所有隱藏項目。

如需篩選的詳細資訊,請參閱篩選 項目 和 依命名空間參考屬性。

GetTable 會使用上層 Folder 之資料夾類型的預設欄設定,傳回 Table。 若要修改預設的資料行集,請使用 Columns 集合物件的 Add、Remove 或 RemoveAll 方法。 當 TableContents 為 olHiddenItems 時,即使上層 Folder 可能是 [連絡人] 資料夾,預設欄位設定一定會是郵件資料夾的預設欄設定。 如需預設欄位設定的詳細資訊,請參閱 Table 物件中顯示的預設屬性。

使用 Table.Restrict 將後續篩選套用至以 Folder 物件為基礎的資料表。

範例

下列程式碼範例說明如何使用 Folder.GetTable 以根據 [收件匣] 中項目的 LastModificationTime,取得 Table 物件。 然後,範例還會列舉並列印這些項目的一些預設屬性值。

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

另請參閱

資料夾物件

支援和意見反應

有關於 Office VBA 或這份文件的問題或意見反應嗎? 如需取得支援服務並提供意見反應的相關指導,請參閱 Office VBA 支援與意見反應。