Items.SetColumns 方法 (Outlook)

缓存某些属性,从而极大地提高 Items 集合中每个项目的那些特定属性的访问速度。

语法

expressionSetColumns( _Columns_ )

表达 一个代表 Items 对象的变量。

参数

名称 必需/可选 数据类型 说明
必需 String 一个包含要缓存的属性的名称的字符串。 此字符串中的属性名以逗号分隔。

备注

SetColumns 方法可用于循环访问 的项目 集合。 如果不使用此方法,则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 已提交
IsConflict VotingOptions

ConversationIndex 属性不能使用 SetColumns 方法进行缓存。 但是,此属性不会导致像上面所列的其他属性的错误。

示例

下面的 Visual Basic for Applications (VBA) 示例使用 集合中获取项的默认任务文件夹,缓存的 主题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

另请参阅

Items 对象

支持和反馈

有关于 Office VBA 或本文档的疑问或反馈? 请参阅 Office VBA 支持和反馈,获取有关如何接收支持和提供反馈的指南。