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

Значение свойства

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 для безопасного ПРОТОКОЛА 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.

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

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