Фильтрация писем с почтового сервера
Фильтрация сообщений по отправителю, получателю или дате
Этот Pop3Client класс, описанный в Подключиться к POP3‑серверу, предоставляет ListMessages() метод, который получает все сообщения из ящика. Чтобы получить только сообщения, соответствующие некоторому условию, используйте перегруженный ListMessages() метод, который принимает MailQuery в качестве аргумента. The MailQuery класс предоставляет различные свойства для указания условий поиска, например, дата, тема, отправитель, получатель и т.д. The MailQueryBuilder класс используется для построения поискового выражения. Сначала задаются все условия и ограничения, а затем MailQuery заполняется запросом, разработанным MailQueryBuilder. Это MailQuery объект класса используется Pop3Client для извлечения отфильтрованной информации с сервера. Эта статья показывает, как фильтровать электронные сообщения из почтового ящика. Первый пример иллюстрирует фильтрацию сообщений по дате и теме. Мы также показываем, как фильтровать по другим критериям и как построить более сложные запросы. Также демонстрируется применение фильтра даты и времени для получения конкретных писем из ящика. Кроме того, показано, как применять фильтрацию с учётом регистра.
Фильтрация сообщений из почтового ящика
Чтобы отфильтровать сообщения из ящика:
- Подключение к POP3‑серверу.
- Создайте экземпляр MailQuery и задать нужные свойства.
- Вызвать Pop3Client.ListMessages(MailQuery query) метод и передайте MailQuery в параметрах, чтобы получить только отфильтрованные сообщения.
В следующем фрагменте кода показано, как подключиться к POP3‑ящику и получить сообщения, пришедшие сегодня и содержащие слово "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.");
Получение сообщений по определённым критериям
Приведённые выше образцы кода показывает, как можно фильтровать сообщения по теме письма и дате. Мы также можем использовать другие свойства для установки поддерживаемых условий. Ниже приведены примеры задания условий с использованием MailQuery.
Следующие фрагменты кода показывают, как фильтровать письма по другим критериям:
- Найти письма, доставленные сегодня.
- Найти письма, полученные в диапазоне.
- Найти письма от конкретного отправителя.
- Найти письма, отправленные с конкретного домена.
- Найти письма, отправленные конкретному получателю.
Сегодняшняя дата
В следующем фрагменте кода показано, как найти письма, доставленные сегодня.
// Emails that arrived today
MailQueryBuilder builder = new MailQueryBuilder();
builder.InternalDate.On(DateTime.Now);
Диапазон дат
В следующем фрагменте кода показано, как найти письма, полученные в диапазоне.
// Emails that arrived in last 7 days
builder.InternalDate.Before(DateTime.Now);
builder.InternalDate.Since(DateTime.Now.AddDays(-7));
Конкретный отправитель
В следующем фрагменте кода показано, как найти письма от конкретного отправителя.
// Get emails from specific sender
builder.From.Contains("saqib.razzaq@127.0.0.1");
Конкретный домен
В следующем фрагменте кода показано, как найти письма, отправленные с конкретного домена.
// Get emails from specific domain
builder.From.Contains("SpecificHost.com");
Конкретный получатель
В следующем фрагменте кода показано, как найти письма, отправленные конкретному получателю.
// Get emails sent to specific recipient
builder.To.Contains("recipient");
Построение сложных запросов
Если разные MailQueryBuilder свойства задаются в отдельных операторах, затем все условия будут совпадать. Например, если мы хотим получить сообщения в диапазоне дат и от конкретного хоста, нам нужно написать три оператора.
Комбинировать запросы с 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));
Комбинировать запросы с OR
MailQueryBuilder предоставляет Or() метод, принимающий два MailQuery экземпляров в качестве параметров. Он получает сообщения, соответствующие хотя бы одному из двух указанных условий. Ниже приведён фрагмент кода, показывающий, как отфильтровать сообщения, в теме которых есть «test» или отправителем является "noreply@host.com". Следующий фрагмент кода демонстрирует, как комбинировать запросы с помощью OR.
// Specify OR condition
builder.Or(builder.Subject.Contains("test"), builder.From.Contains("noreply@host.com"));
Фильтры с учётом регистра
API также предоставляет возможность фильтровать письма из ящика на основе чувствительных к регистру критериев. Следующие методы позволяют выполнять поиск писем с указанием флага чувствительности к регистру.
- Method Aspose.Email.StringComparisonField.Contains(string value, bool ignoreCase)
- Method Aspose.Email.StringComparisonField.Equals(string value, bool ignoreCase)
- Method Aspose.Email.StringComparisonField.NotContains(string value, bool ignoreCase)
- Method 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);