Table オブジェクト (Outlook)

Folder オブジェクトまたは Search オブジェクトのアイテム データの集合を表します。アイテムはテーブルの行になり、プロパティはテーブルの列になります。

注釈

テーブル は読み取り専用で動的な行セットの フォルダー または 検索 オブジェクト内のデータを表します。 Folder.GetTable または Search.GetTable を使用して、フォルダーまたは検索フォルダー内の項目のセットを表す Table オブジェクトを取得します。 Table オブジェクトを Folder.GetTable から取得する場合は、さらに (Table.Restrict で) フィルターを指定して、フォルダー内のアイテムのサブセットを取得できます。 フィルターを指定しない場合は、フォルダー内のすべての項目を取得します。

既定では、返される テーブル 内の各項目には、そのプロパティの既定のサブセットのみが含まれています。 フォルダー内の項目としては、 テーブル の各行、各列をし、インメモリの軽量な行セットとなり、高速な列挙では、 テーブル のプロパティ、フォルダー内のアイテムのフィルター処理と見なすことができます。 基になるフォルダーの追加と削除は、 テーブル 内の行に反映されますが、行の削除と追加、変更、 テーブル 上で任意のイベントはサポートされません。 オブジェクトは、 テーブル の行が必要な場合は、既定の テーブル 内の列のエントリ Id からその行のエントリ ID を取得して、完全なアイテムを取得するのには、 名前空間 オブジェクトの GetItemFromID メソッドを使用して、 MailItemContactItem など、読み取り/書き込み操作をサポートします。 Table の既定の列の詳細については、「Table オブジェクトに表示される既定のプロパティ」を参照してください。

Table オブジェクトの詳細については、「フォルダー内のアイテムの列挙、検索、フィルター」を参照してください。

次のコード例は、 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

メソッド

名前
FindNextRow
FindRow
GetArray
GetNextRow
GetRowCount
MoveToStart
Restrict
Sort

プロパティ

名前
アプリケーション
クラス
EndOfTable
Parent
Session

関連項目

Table オブジェクト メンバーOutlook オブジェクト モデル リファレンス

サポートとフィードバック

Office VBA またはこの説明書に関するご質問やフィードバックがありますか? サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。