Método Items.SetColumns (Outlook)
Armazena em cache determinadas propriedades para acesso extremamente rápido a propriedades específicas de cada item da coleção Items.
Sintaxe
expression. SetColumns( _Columns_ )
Expressão Uma variável que representa um objeto Items .
Parâmetros
| Nome | Obrigatório/Opcional | Tipo de dados | Descrição |
|---|---|---|---|
| Columns | Obrigatório | String | Uma cadeia de caracteres que contém os nomes das propriedades a serem armazenadas em cache. Os nomes das propriedades são delimitados por vírgula nessa cadeia de caracteres. |
Comentários
O método SetColumns é útil para iterar em uma coleção Items. Se você não usar esse método, Microsoft Outlook deve abrir cada item para acessar a propriedade. Com o método SetColumns, o Outlook somente verifica as propriedades que você tiver no cache e fornece acesso rápido e somente leitura a essas propriedades.
Depois de aplicar o método SetColumns nas propriedades específicas da coleção, você não pode ler as outras propriedades dessa coleção; propriedades que não estiverem armazenadas serão retornadas vazias. Você não pode escrever ou para qualquer uma das propriedades dessa coleção. Como alternativa, se você precisar de acesso de leitura / gravação, fast a um conjunto de itens, use o objeto Table.
SetColumns não pode ser usado e causará um erro, com qualquer propriedade que retorna um objeto. Ele não pode ser usado com as seguintes propriedades:
| AutoResolvedWinner | InternetCodePage |
|---|---|
| BodyFormat | MemberCount |
| Categories | ReceivedByEntryID |
| Children | ReceivedOnBehalfOfEntryID |
| Class | RecurrenceState |
| Companies | ReplyRecipients |
| DLName | ResponseState |
| DownloadState | Salvo |
| EntryID | Sent |
| HTMLBody | submitted |
| IsConflict | VotingOptions |
Propriedade ConversationIndex não pode ser armazenados em cache usando o método SetColumns. No entanto, essa propriedade não resultará em erro como as outras propriedades listadas acima.
Exemplo
Visual Basic a seguir para exemplo Applications (VBA) usa a coleção Items para obter os itens de pasta de tarefas padrão, armazena em cache as propriedades Subject e DueDate e, em seguida, exibe o assunto e as datas de vencimento cada por sua vez.
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
Confira também
Suporte e comentários
Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.