Filtrowanie e‑maili z serwera pocztowego

Filtrowanie wiadomości według nadawcy, odbiorcy lub daty

Ten Pop3Client klasa, opisana w Połącz się z serwerem POP3, zapewnia ListMessages() metoda, która pobiera wszystkie wiadomości ze skrzynki. Aby otrzymać tylko wiadomości spełniające określony warunek, użyj przeciążonej ListMessages() metoda, która przyjmuje MailQuery jako argument. MailQuery klasa zapewnia różne właściwości do określania warunków zapytania, np. data, temat, nadawca, odbiorca itp.  MailQueryBuilder klasa jest używana do budowania wyrażenia wyszukiwania. Najpierw ustawia się wszystkie warunki i ograniczenia, a następnie MailQuery jest wypełniony zapytaniem opracowanym przez MailQueryBuilder. The MailQuery obiekt klasy jest używany przez Pop3Client aby wyodrębnić przefiltrowane informacje z serwera. Ten artykuł pokazuje, jak filtrować wiadomości e‑mail z skrzynki pocztowej. Pierwszy przykład ilustruje filtrowanie wiadomości według daty i tematu. Pokazujemy również, jak filtrować według innych kryteriów oraz jak budować bardziej złożone zapytania. Prezentujemy zastosowanie filtru daty i godziny w celu pobrania konkretnych e‑maili ze skrzynki. Dodatkowo pokazujemy, jak zastosować filtrowanie rozróżniające wielkość liter.

Filtrowanie wiadomości z skrzynki pocztowej

Aby filtrować wiadomości ze skrzynki:

  1. Połącz z serwerem POP3.
  2. Utwórz instancję MailQuery i ustawić żądane właściwości.
  3. Wywołaj Pop3Client.ListMessages(MailQuery query) metodę i przekazać MailQuery w parametrach, aby otrzymać tylko przefiltrowane wiadomości.

Poniższy fragment kodu pokazuje, jak połączyć się z skrzynką POP3 i pobrać wiadomości, które przybyły dzisiaj oraz mają w temacie słowo "newsletter".

// Connect and log in to POP3
const string host = "host";
const int port = 110;
const string username = "user@host.com";
const string password = "password";
Pop3Client client = new Pop3Client(host, port, username, password);

// Set conditions, Subject contains "Newsletter", Emails that arrived today
MailQueryBuilder builder = new MailQueryBuilder();      
builder.Subject.Contains("Newsletter");
builder.InternalDate.On(DateTime.Now);
// Build the query and Get list of messages
MailQuery query = builder.GetQuery();
Pop3MessageInfoCollection messages = client.ListMessages(query);
Console.WriteLine("Pop3: " + messages.Count + " message(s) found.");

Pobieranie wiadomości według konkretnych kryteriów

Powyższe przykłady kodu pokazuje, jak można filtrować wiadomości na podstawie tematu e‑maila i daty. Możemy również używać innych właściwości do ustawiania innych obsługiwanych warunków. Poniżej znajdują się niektóre przykłady ustawiania warunków przy użyciu MailQuery.

Poniższe fragmenty kodu pokazują, jak filtrować e‑maile według innych kryteriów:

  • Znajdź e‑maile dostarczone dzisiaj.
  • Znajdź e‑maile odebrane w określonym przedziale.
  • Znajdź e‑maile od określonego nadawcy.
  • Znajdź e‑maile wysłane z określonej domeny.
  • Znajdź e‑maile wysłane do określonego odbiorcy.

Dzisiejsza data

Poniższy fragment kodu pokazuje, jak znaleźć e‑maile dostarczone dzisiaj.

// Emails that arrived today
MailQueryBuilder builder = new MailQueryBuilder();
builder.InternalDate.On(DateTime.Now);

Zakres dat

Poniższy fragment kodu pokazuje, jak znaleźć e‑maile odebrane w określonym przedziale.

// Emails that arrived in last 7 days
builder.InternalDate.Before(DateTime.Now);
builder.InternalDate.Since(DateTime.Now.AddDays(-7));

Określony nadawca

Poniższy fragment kodu pokazuje, jak znaleźć e‑maile od określonego nadawcy.

// Get emails from specific sender
builder.From.Contains("saqib.razzaq@127.0.0.1");

Określona domena

Poniższy fragment kodu pokazuje, jak znaleźć e‑maile wysłane z określonej domeny.

// Get emails from specific domain
builder.From.Contains("SpecificHost.com");

Określony odbiorca

Poniższy fragment kodu pokazuje, jak znaleźć e‑maile wysłane do określonego odbiorcy.

// Get emails sent to specific recipient
builder.To.Contains("recipient");

Budowanie złożonych zapytań

Jeśli różne MailQueryBuilder właściwości są ustawiane w oddzielnych instrukcjach, wtedy wszystkie warunki będą spełnione. Na przykład, jeśli chcemy pobrać wiadomości z określonego zakresu dat i od konkretnego hosta, musimy napisać trzy instrukcje.

Łącz zapytania przy użyciu AND

Poniższy fragment kodu pokazuje, jak łączyć zapytania przy użyciu AND.

// Emails from specific host, get all emails that arrived before today and all emails that arrived since 7 days ago
builder.From.Contains("SpecificHost.com");
builder.InternalDate.Before(DateTime.Now);
builder.InternalDate.Since(DateTime.Now.AddDays(-7));

Łącz zapytania przy użyciu OR

MailQueryBuilder udostępnia Or() metoda przyjmująca dwa MailQuery instancje jako parametry. Pobiera wiadomości, które spełniają dowolny z dwóch określonych warunków. Poniższy fragment kodu pokazuje, jak filtrować wiadomości, które mają w temacie „test” lub jako nadawcę "noreply@host.com". Przykład pokazuje, jak łączyć zapytania operatorem OR.

// Specify OR condition
builder.Or(builder.Subject.Contains("test"), builder.From.Contains("noreply@host.com"));

Filtry rozróżniające wielkość liter

API zapewnia również możliwość filtrowania e‑mail z skrzynki na podstawie kryteriów wrażliwych na wielkość liter. Następujące metody umożliwiają wyszukiwanie e‑mail z określeniem flagi wrażliwości na wielkość liter.

  • Metoda Aspose.Email.StringComparisonField.Contains(string value, bool ignoreCase)
  • Metoda Aspose.Email.StringComparisonField.Equals(string value, bool ignoreCase)
  • Metoda Aspose.Email.StringComparisonField.NotContains(string value, bool ignoreCase)
  • Metoda Aspose.Email.StringComparisonField.NotEquals(string value, bool ignoreCase)
// IgnoreCase is True
MailQueryBuilder builder1 = new MailQueryBuilder();
builder1.From.Contains("tesT", true);
MailQuery query1 = builder1.GetQuery();
Pop3MessageInfoCollection messageInfoCol1 = client.ListMessages(query1);