SmtpClient.EnableSsl Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Укажите, используется ли SmtpClient протокол SSL для шифрования подключения.
public:
property bool EnableSsl { bool get(); void set(bool value); };public bool EnableSsl { get; set; }member this.EnableSsl : bool with get, setPublic Property EnableSsl As BooleanЗначение свойства
true Значение SmtpClient , falseесли используется ПРОТОКОЛ SSL; в противном случае . Значение по умолчанию — false.
Примеры
В следующем примере кода устанавливается SSL-соединение с SMTP-сервером и используется подключение для отправки сообщения электронной почты.
public static void CreateTestMessage(string server)
{
string to = "jane@contoso.com";
string from = "ben@contoso.com";
MailMessage message = new MailMessage(from, to);
message.Subject = "Using the new SMTP client.";
message.Body = @"Using this new feature, you can send an email message from an application very easily.";
SmtpClient client = new SmtpClient(server);
// Credentials are necessary if the server requires the client
// to authenticate before it will send email on the client's behalf.
client.UseDefaultCredentials = true;
client.EnableSsl = true;
client.Send(message);
}
Комментарии
Свойство EnableSsl указывает, используется ли SSL для доступа к указанному почтовому серверу SMTP.
Значение по умолчанию для этого свойства также можно задать в файле конфигурации компьютера или приложения. Все изменения, внесенные в EnableSsl свойство, переопределяют параметры файла конфигурации.
Класс SmtpClient поддерживает только расширение службы SMTP для безопасного SMTP-протокола по протоколу Transport Layer Security, как определено в RFC 3207. В этом режиме сеанс SMTP начинается на незашифрованном канале, а затем команда STARTTLS выдана клиентом серверу, чтобы переключиться на безопасное взаимодействие с помощью SSL. Дополнительные сведения см. в статье RFC 3207, опубликованной в Группе разработчиков Интернета (IETF).
Альтернативный метод подключения заключается в том, что сеанс SSL устанавливается перед отправкой любых команд протокола. Этот метод подключения иногда называется SMTP/SSL, SMTP через SSL или SMTPS, а по умолчанию использует порт 465. Этот альтернативный метод подключения с использованием SSL в настоящее время не поддерживается.
Можно указать ClientCertificates , какие сертификаты клиента следует использовать для установления SSL-подключения. Этот ServerCertificateValidationCallback параметр позволяет отклонять сертификат, предоставленный SMTP-сервером. Свойство SecurityProtocol позволяет указать версию протокола SSL.
Замечание
EnableSsl Если для свойства задано trueзначение, а почтовый сервер SMTP не объявляет STARTTLS в ответе на команду EHLO, вызов Send или SendAsync методы вызовет исключениеSmtpException.
