Items.SetColumns 方法 (Outlook)
缓存某些属性,从而极大地提高 Items 集合中每个项目的那些特定属性的访问速度。
语法
expression。 SetColumns
( _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
另请参阅
支持和反馈
有关于 Office VBA 或本文档的疑问或反馈? 请参阅 Office VBA 支持和反馈,获取有关如何接收支持和提供反馈的指南。