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 のサポートおよびフィードバックを参照してください。