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 использует SSL; в противном случае — false. Значение по умолчанию — 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 для secure SMTP over 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.
