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

Definition

Especifique si el objeto SmtpClient utiliza SSL (Secure Sockets Layer) para cifrar la conexión. 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

Property Value

Es true si el objeto SmtpClient utiliza SSL; en caso contrario, es false. true if the SmtpClient uses SSL; otherwise, false. El valor predeterminado es false. The default is false.

Examples

En el ejemplo de código siguiente se establece una conexión SSL con el servidor SMTP y usa la conexión para enviar un correo electrónico.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);
}

Remarks

El EnableSsl propiedad especifica si SSL se utiliza para tener acceso al servidor de correo SMTP especificado.The EnableSsl property specifies whether SSL is used to access the specified SMTP mail server.

El valor predeterminado de esta propiedad también puede establecerse en una máquina o un archivo de configuración de aplicación.The default value for this property can also be set in a machine or application configuration file. Los cambios realizados en el EnableSsl el archivo de configuración de reemplazo de propiedad.Any changes made to the EnableSsl property override the configuration file settings.

La SmtpClient clase sólo admite la extensión de servicio SMTP para SMTP seguro a través de la seguridad de la capa de transporte como se define en RFC 3207.The SmtpClient class only supports the SMTP Service Extension for Secure SMTP over Transport Layer Security as defined in RFC 3207. En este modo, la sesión SMTP comienza en un canal no cifrado, a continuación, se emite un comando STARTTLS por el cliente al servidor para cambiar a una comunicación segura mediante 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. Vea RFC 3207 publicada por Internet Engineering Task Force (IETF) para obtener más información.See RFC 3207 published by the Internet Engineering Task Force (IETF) for more information.

Un método de conexión alternativo es donde se establece por adelantado una sesión SSL antes de cualquier protocolo que se envían comandos.An alternate connection method is where an SSL session is established up front before any protocol commands are sent. Este método de conexión a veces se denomina SMTP/SSL, usa el puerto 465 SMTP a través de SSL o SMTPS y de forma predeterminada.This connection method is sometimes called SMTP/SSL, SMTP over SSL, or SMTPS and by default uses port 465. Este método de conexión alternativo mediante SSL no se admite actualmente.This alternate connection method using SSL is not currently supported.

Puede usar ClientCertificates para especificar qué certificados de cliente se deben usar para establecer la conexión SSL.You can use ClientCertificates to specify which client certificates should be used to establish the SSL connection. El ServerCertificateValidationCallback permite rechazar el certificado proporcionado por el servidor SMTP.The ServerCertificateValidationCallback allows you to reject the certificate provided by the SMTP server. El SecurityProtocol propiedad le permite especificar la versión del protocolo SSL para usar.The SecurityProtocol property allows you to specify the version of the SSL protocol to use.

Nota

Si el EnableSsl propiedad está establecida en true, y el servidor de correo SMTP no anuncia STARTTLS en la respuesta a la EHLO comando y, a continuación, una llamada a la Send o SendAsync métodos producirán un 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.

Applies to

See Also