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, set
Public 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.

Применяется к

См. также раздел