Filtrar Mensagens da Caixa de Correio Exchange
Filtrando Mensagens usando EWS
A interface IEWSClient fornece o método ListMessages() que obtém todas as mensagens de uma caixa de correio. Para obter apenas mensagens que correspondem a alguma condição, use o método ListMessages() sobrecarga que recebe a classe MailQuery como argumento. A classe MailQuery fornece várias propriedades para especificar condições, por exemplo, data, assunto, remetente e destinatário. Além disso, a API também permite aplicar filtros de sensibilidade a maiúsculas e minúsculas para recuperar e-mails da caixa de correio.
Filtrar Mensagens com Base em Critérios
Para obter mensagens filtradas de uma caixa de correio:
- Conecte-se ao servidor Exchange.
- Crie uma instância de MailQuery e defina as propriedades desejadas.
- Chame o método IEWSClient.ListMessages() e passe o MailQuery nos parâmetros para obter apenas as mensagens filtradas.
O seguinte trecho de código mostra como se conectar a uma caixa de correio IMAP e obter mensagens que contêm a string “Newsletter” no assunto e que foram enviadas hoje.
Filtrar Mensagens pela Data de Hoje
O seguinte trecho de código mostra como filtrar todos os e-mails com base na data de hoje.
Filtrar Mensagens por Intervalo de Datas
O seguinte trecho de código mostra como filtrar todos os e-mails com base no intervalo de datas.
Filtrar Mensagens por Remetente Específico
O seguinte trecho de código mostra como filtrar todos os e-mails com base em um remetente específico.
Filtrar Mensagens por Domínio Específico
O seguinte trecho de código mostra como filtrar todos os e-mails com base em um domínio específico.
Filtrar Mensagens por Destinatário Específico
O seguinte trecho de código mostra como filtrar todos os e-mails com base em um destinatário específico.
Filtrar Mensagens pelo MessageID
O seguinte trecho de código mostra como filtrar todos os e-mails com base no MessageID.
Filtrar Mensagens por Todas as Notificações de Entrega de Correio
O seguinte trecho de código mostra como filtrar todos os e-mails com base em todas as notificações de entrega de correio.
Filtrar Mensagens por Tamanho da Mensagem
Construindo Consultas Complexas
Se diferentes propriedades do MailQueryBuilder forem definidas em uma declaração separada, todas as condições serão correspondidas. Por exemplo, para obter uma mensagem em um intervalo de datas específico e de um host específico, escreva três declarações:
Combinando Consultas com AND
O seguinte trecho de código mostra como combinar consultas com AND.
Combinando Consultas com OR
O MailQueryBuilder fornece o método Or() que recebe duas instâncias de MailQuery como parâmetros. Ele obtém mensagens que correspondem a qualquer uma das duas condições especificadas. O exemplo abaixo filtra mensagens que têm a palavra “teste” no assunto ou “noreply@host.com” como remetente. O seguinte trecho de código mostra como combinar consultas com OR.
Filtragem de E-mails Sensíveis a Maiúsculas e Minúsculas
Os e-mails podem ser filtrados com base na sensibilidade a maiúsculas e minúsculas, especificando a flag IgnoreCase nos critérios de filtragem, conforme mostrado no seguinte trecho de código.
Filtrando Mensagens com Suporte a Paginação
Ordenando mensagens filtradas em ordem crescente/decrescente
A filtragem de e-mails pode ser suportada com a ordenação de mensagens em ordem crescente/decrescente. Neste caso, o método OrderBy é usado para especificar a ordem em que os resultados de uma pesquisa de e-mail são ordenados usando a classe MailQueryBuilder. Este método permite que você defina critérios de ordenação para uma consulta de pesquisa, especificando se os resultados devem ser ordenados em ordem crescente ou decrescente com base em uma propriedade específica.
O método aceita o parâmetro ascending, que especifica a ordem de classificação para a propriedade especificada. Se o parâmetro ascending for verdadeiro, isso significa que os resultados da pesquisa devem ser ordenados em ordem crescente. Por outro lado, se o parâmetro ascending for falso, isso significa que os resultados da pesquisa devem ser ordenados em ordem decrescente.
MailQueryBuilder builder = new MailQueryBuilder();
builder.Subject.Contains("Report");
builder.InternalDate.Since(new DateTime(2020, 1, 1));
builder.Subject.OrderBy(true); // ordena o assunto em ordem crescente
builder.InternalDate.OrderBy(false); // ordena a data em ordem decrescente
MailQuery query = builder.GetQuery();
// Obtenha a lista de mensagens
ExchangeMessageInfoCollection messages = client.ListMessages(client.MailboxInfo.InboxUri, query, false);
No trecho de código acima, o método OrderBy é aplicado duas vezes, uma para o assunto e outra para a data dos e-mails. Como resultado da execução do método ListMessages com a solicitação enviada, obteremos uma lista de mensagens com o assunto contendo a palavra “Report” que foram recebidas na data especificada ou depois dessa data. Ao mesmo tempo, os resultados serão ordenados por assunto em ordem crescente. Isso significa que as mensagens serão organizadas alfabeticamente de A a Z, dependendo do seu assunto. Além disso, os resultados serão ordenados por data em ordem decrescente. Isso significa que as postagens serão organizadas do mais novo para o mais antigo.