Items.SetColumns メソッド (Outlook)
特定のプロパティをキャッシュに格納して、 Items コレクションの各アイテムの特定のプロパティに非常に早くアクセスできるようにします。
構文
式。 SetColumns
( _Columns_
)
式Items オブジェクトを表す変数。
パラメーター
名前 | 必須 / オプション | データ型 | 説明 |
---|---|---|---|
列 | 必須 | String | キャッシュに格納するプロパティの名前を含む文字列を指定します。 この文字列内では、プロパティ名をコンマで区切ります。 |
注釈
SetColumns メソッドは、 Items コレクションを反復処理するのに便利です。 このメソッドを使用しない場合、 Microsoft Outlookは、プロパティにアクセスするには、各項目を開く必要があります。 、 SetColumns メソッドを使用して Outlook はキャッシュに格納されて、し、これらのプロパティを高速で読み取り専用のアクセスを提供するプロパティだけをチェックします。
コレクションの特定のプロパティに対して SetColumns メソッドを実行すると、そのコレクション内の他のプロパティを読み取ることができなくなります (つまり、キャッシュに格納されていないプロパティを取得しようとすると、空の値が返されます)。 また、そのコレクションのプロパティへの書き込みもできなくなります。 または、一連の項目への読み取り/書き込み高速アクセスが必要な場合は、 Table オブジェクトを使用します。
SetColumns ことはできませんが使用され、オブジェクトを返す任意のプロパティでは、エラーが発生します。 次のプロパティで使用することはできません。
AutoResolvedWinner | InternetCodePage |
---|---|
BodyFormat | MemberCount |
カテゴリ | ReceivedByEntryID |
Children | ReceivedOnBehalfOfEntryID |
Class | RecurrenceState |
Companies | ReplyRecipients |
DLName | ResponseState |
DownloadState | Saved |
EntryID | Sent |
HtmlBody | submitted |
IsConflict | VotingOptions |
SetColumns メソッドを使用して ConversationIndex プロパティをキャッシュすることはできません。 ただし、このプロパティは、前述の他のプロパティと同じようにエラーは発生しません。
例
次の Visual Basic for Applications (VBA) の例では、 Items コレクションを使用して、項目を取得するのにはフォルダーを既定のタスク、 件名 と DueDate プロパティをキャッシュして、件名が表示され、期日ごとにします。
Sub SortByDueDate()
Dim myNameSpace As Outlook.NameSpace
Dim myFolder As Outlook.Folder
Dim myItem As Object
Dim myItems As Outlook.Items
Set myNameSpace = Application.GetNamespace("MAPI")
Set myFolder = myNameSpace.GetDefaultFolder(olFolderTasks)
Set myItems = myFolder.Items
myItems.SetColumns ("Subject, DueDate")
For Each myItem In myItems
MsgBox myItem.Subject & " " & myItem.DueDate
Next myItem
End Sub
関連項目
サポートとフィードバック
Office VBA またはこの説明書に関するご質問やフィードバックがありますか? サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。