Enumerar, pesquisar e filtrar itens em uma pasta

O modelo de objeto do Outlook fornece vários pontos de entrada que dão suporte à enumeração, pesquisa e filtragem de itens em uma pasta.

Enumerando itens

Os objetos Itens, Tabela e Seleção dão suporte à enumeração de itens em uma pasta. No entanto, há cenários específicos em que você escolheria um em vez dos outros.

Você pode obter uma coleção Itens chamando Folder.Items que retorna os itens na pasta. Cada objeto de item na coleção é concluído com todas as suas propriedades internas explícitas e propriedades personalizadas e dá suporte a operações de gravação de leitura. A coleção Itens também dá suporte a filtros e eventos que disparam quando os itens são adicionados, alterados ou removidos da coleção.

Use Folder.GetTable ou Search.GetTable para obter um objeto Table que representa um conjunto de itens em uma pasta ou pasta de pesquisa. Em ambos os casos, você pode especificar um filtro para obter um subconjunto dos itens na pasta ou, se não especificar nenhum filtro, obtenha todos os itens na pasta. Por padrão, cada item na tabela retornada contém apenas um subconjunto de padrão de suas propriedades.

Você pode exibir cada linha de uma Tabela como um item na pasta, cada coluna como uma propriedade do item e a Tabela é um conjunto de linhas de peso leve na memória que permite enumeração rápida e filtragem de itens na pasta. Embora as adições e exclusões da pasta subjacente sejam refletidas pelas linhas na Tabela, a Tabela não dá suporte a eventos para adição, alteração e remoção de linhas.

Se precisar de um objeto gravável da linha da tabela, obter o ID de entrada dessa linha do padrão EntryID coluna da tabela e use o método GetItemFromID do objeto NameSpace para obter um item completo, como MailItem ou ContactItem, que suporta operações de leitura / gravação. Para obter mais informações sobre colunas padrão em uma Tabela, confira Propriedades efault exibidas em um objeto table.

O objeto Selection dá suporte à enumeração de itens que um usuário selecionou no momento em um explorador. Como o explorador exibe o conteúdo de uma pasta, o objeto Selection dá suporte à enumeração de itens nessa pasta de acordo com a seleção do usuário.

Nota Uma pasta no Outlook pode conter itens heterogêneos. Por exemplo, a pasta Contatos dá suporte à criação de itens de contato e itens de lista de distribuição por padrão. Como os objetos Itens, Tabela e Seleção encapsulam itens em uma pasta ou pasta de pesquisa, os itens neles não necessariamente têm a mesma classe de mensagem. Ao enumerar itens nessas coleções e objetos, é uma boa prática primeiro verificar a classe de mensagem de cada item antes de acessar as propriedades do item.

Pesquisar e filtrar itens

Os objetos Itens, Tabela, Aplicativo e Exibiçãodão suporte à pesquisa e filtragem de itens em uma pasta. A tabela a seguir descreve e compara estes pontos de entrada:

Ponto de entrada	Action	Objeto do Filtro de Pesquisa	Suporte para filtro Jet	Suporte para filtro DASL	Comentários
Application.AdvancedSearch	Define os critérios de um objeto Search e retorna o objeto Search . Search.Results especifica os resultados da pesquisa. Search.Save atualiza uma pasta de pesquisa com os resultados da pesquisa.	Folder	Não	Sim
Folder.GetTable	Retorna uma Tabela de itens em uma pasta com base em qualquer filtro determinado.	Folder	Sim	Sim	Não há suporte para determinadas propriedades no filtro Tabela , incluindo propriedades binárias, e conteúdo do corpo HTML ou RTF. Para obter mais informações, consulte Propriedades sem suporte em um objeto ou filtro Table.
Itens.Localizar	Pesquisa o primeiro item que satisfaça o filtro especificado.	Folder	Sim	Não	Não há suporte para determinadas propriedades no filtro, incluindo Corpo. Para obter mais informações, consulte Itens.Localizar.
Itens.Restringir	Filtra determinado conjunto de itens com base em restrições especificadas e retorna outra coleção Itens .	Folder	Sim	Sim	Não há suporte para determinadas propriedades no filtro, por exemplo, Body. Para obter mais informações, consulte Items.Restrict.
Search.GetTable	Retorna uma Tabela de itens em uma pasta de pesquisa com base em qualquer filtro derivado de Application.AdvancedSearch.	Pasta pesquisar	Não	Sim	Search.GetTable deriva seu filtro do objeto Search (especificamente a propriedade Search.Filter ) retornado do Application.AdvancedSearch.
Table.Restrict	Filtra linhas na tabela determinada com base em um filtro especificado e retorna outro objeto Table .	Folder	Sim	Sim	Não há suporte para determinadas propriedades no filtro Tabela , incluindo propriedades binárias, e conteúdo do corpo HTML ou RTF. Para obter mais informações, consulte Propriedades sem suporte em um objeto ou filtro Table.
Exibir.Filtrar	Define o filtro de uma exibição sem alterar o XML do modo de exibição. Definir o filtro para um modo de exibição só altera a exibição na interface do usuário e não resulta em uma coleção de itens filtrados.	Folder	Não	Sim
View.XML	Obtém ou define o XML para uma exibição. Modificar o <nó Filtro> altera o filtro do modo de exibição. A configuração do XML para uma exibição só altera a exibição na interface do usuário e não resulta em uma coleção de itens filtrados.	Folder	Não	Sim	Exibir XML está sendo preterido. Use o modelo de objeto Exibir para exibir exibições.

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.