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 по протоколу TLS, как определено в RFC 3207. В этом режиме сеанс SMTP начинается на незашифрованном канале, после чего клиент отправляет на сервер команду STARTTLS, чтобы переключиться на безопасное взаимодействие с помощью SSL. Дополнительные сведения см. в RFC 3207, опубликованных с помощью IETF.

Альтернативный способ подключения заключается в том, где сеанс SSL устанавливается перед отправкой любых команд протокола. Этот метод подключения иногда называют SMTP/SSL, SMTP через SSL или SMTP и по умолчанию использует порт 465. Этот альтернативный метод подключения, использующий SSL, в настоящее время не поддерживается.

С помощью можно ClientCertificates указать, какие сертификаты клиентов следует использовать для установления SSL-соединения. ServerCertificateValidationCallbackПозволяет отклонять сертификат, предоставленный SMTP-сервером. SecurityProtocolСвойство позволяет указать версию протокола SSL для использования.

Примечание

Если EnableSsl свойство имеет значение true , а почтовый сервер SMTP не объявляет STARTTLS в ответ на команду EHLO, то вызов Send методов или выдаст SendAsync исключение SmtpException .

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

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