SmtpClient.EnableSsl SmtpClient.EnableSsl SmtpClient.EnableSsl SmtpClient.EnableSsl Property

Определение

Указывает, использует ли SmtpClient протокол SSL для шифрования подключения.Specify whether the SmtpClient uses Secure Sockets Layer (SSL) to encrypt the connection.

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.true if the SmtpClient uses SSL; otherwise, false. Значение по умолчанию — false.The default is false.

Примеры

В следующем примере кода устанавливает соединение SSL с SMTP-сервера и использует соединение для отправки сообщения электронной почты.The following code example establishes an SSL connection with the SMTP server and uses the connection to send an email.

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.The EnableSsl property specifies whether SSL is used to access the specified SMTP mail server.

Значение по умолчанию для этого свойства можно настроить на машине или файла конфигурации приложения.The default value for this property can also be set in a machine or application configuration file. Любые изменения, внесенные в EnableSsl свойство переопределить параметры файла конфигурации.Any changes made to the EnableSsl property override the configuration file settings.

SmtpClient Класс поддерживает только расширения службы SMTP для Secure SMTP через безопасность на транспортном уровне согласно определению в RFC 3207.The SmtpClient class only supports the SMTP Service Extension for Secure SMTP over Transport Layer Security as defined in RFC 3207. В этом режиме сеанс SMTP начинается на незащищенный канал, а затем выдает команду STARTTLS клиента к серверу, чтобы переключиться в режим безопасной связи по протоколу SSL.In this mode, the SMTP session begins on an unencrypted channel, then a STARTTLS command is issued by the client to the server to switch to secure communication using SSL. См. в разделе 3207 RFC, опубликованных с IETF Internet Engineering Task Force () Дополнительные сведения.See RFC 3207 published by the Internet Engineering Task Force (IETF) for more information.

Метод дополнительное подключение является, когда сеанс SSL, устанавливается заранее, перед любой протокол, которые отправляют команды.An alternate connection method is where an SSL session is established up front before any protocol commands are sent. Этот способ подключения иногда называют SMTP/SSL, SMTP через SSL или SMTPS и по умолчанию используется порт 465.This connection method is sometimes called SMTP/SSL, SMTP over SSL, or SMTPS and by default uses port 465. Этот альтернативный способ подключения с помощью протокола SSL в настоящее время не поддерживается.This alternate connection method using SSL is not currently supported.

Можно использовать ClientCertificates для указания, какие сертификаты клиента следует использовать для установления соединения SSL.You can use ClientCertificates to specify which client certificates should be used to establish the SSL connection. ServerCertificateValidationCallback Позволяет отклонять сертификат, предоставленный для SMTP-сервера.The ServerCertificateValidationCallback allows you to reject the certificate provided by the SMTP server. SecurityProtocol Свойство позволяет указать версию протокола SSL для использования.The SecurityProtocol property allows you to specify the version of the SSL protocol to use.

Примечание

Если EnableSsl свойству true, и почтового SMTP-сервера не объявляет команду STARTTLS в ответ на команду EHLO, затем вызов Send или SendAsync методы создадут исключение SmtpException.If the EnableSsl property is set to true, and the SMTP mail server does not advertise STARTTLS in the response to the EHLO command, then a call to the Send or SendAsync methods will throw an SmtpException.

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

Дополнительно