ИнтернетПочта.Выбрать (InternetMail.Get)

ИнтернетПочта (InternetMail)

Выбрать (Get)

Доступен, начиная с версии 8.0.

Синтаксис:

Выбрать(<УдалятьСообщения>, <МассивЗаголовковСообщенийИлиИдентификаторов>, <ОтмечатьКакПрочтенные>)

Параметры:

<УдалятьСообщения> (необязательный)

Тип: Булево.
Истина - удалять выбранные сообщения с сервера.
Значение по умолчанию: Истина.

<МассивЗаголовковСообщенийИлиИдентификаторов> (необязательный)

Тип: Массив.
Массив, содержащий либо заголовки сообщений, либо серверные идентификаторы сообщений, которые необходимо получить.
Для IMAP соединения массив может содержать порядковые номера сообщений в текущем почтовом ящике (см. ТекущийПочтовыйЯщик).
Значение по умолчанию: Пустой массив.

<ОтмечатьКакПрочтенные> (необязательный)

Тип: Булево.
Отмечать письма на сервере как прочтенные.
Актуален только для IMAP, для протокола POP3 единственное допустимое значение - Истина.

В режиме совместимости конфигурации Версия8_3_5 значения по умолчанию следующие:

если задан второй параметр (<МассивЗаголовковСообщенийИлиИдентификаторов>), то - Истина,
в противном случае - Ложь.

Значение по умолчанию: Истина.

Возвращаемое значение:

Тип: Массив.
Массив объектов типа ИнтернетПочтовоеСообщение.
Если параметр МассивЗаголовковСообщенийИлиИдентификаторов содержит пустой массив или не был указан, то возвращаются все сообщения с сервера в полном объеме.

Описание:

Используется для получения сообщений с сервера.

Доступность:

Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

Пример:

Профиль = Новый ИнтернетПочтовыйПрофиль;
ЗаполнитьПрофиль(Профиль);

Почта = Новый ИнтернетПочта;
Почта.Подключиться(Профиль);

Сообщения = Почта.Выбрать(Истина);

Если Сообщения.Количество() = 0 Тогда

    Сообщить("На сервере сообщений нет.");

КонецЕсли;

Почта.Отключиться();

См. также:

ИнтернетПочта, метод ПолучитьЗаголовки
ИнтернетПочта, метод ПолучитьИдентификаторы
ИнтернетПочта, метод ПолучитьКоличествоСообщений
ИнтернетПочта, свойство ТекущийПочтовыйЯщик

Использование в версии:

Доступен, начиная с версии 8.0.

Методическая информация