SmtpClient.EnableSsl Eigenschaft

Definition

Namespace:

System.Net.Mail

Assembly:

System.Net.Mail.dll

Quelle:

SmtpClient.cs

Geben Sie an, ob der SmtpClient die Verbindung mit SSL (Secure Sockets Layer) verschlüsselt.

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

Eigenschaftswert

Boolean

true, wenn der SmtpClient SSL verwendet, andernfalls false. Der Standardwert ist false.

Beispiele

Im folgenden Codebeispiel wird eine SSL-Verbindung mit dem SMTP-Server hergestellt und die Verbindung zum Senden einer E-Mail verwendet.

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);
}

Hinweise

Die EnableSsl -Eigenschaft gibt an, ob SSL für den Zugriff auf den angegebenen SMTP-E-Mail-Server verwendet wird.

Der Standardwert für diese Eigenschaft kann auch in einer Computer- oder Anwendungskonfigurationsdatei festgelegt werden. Alle An der EnableSsl Eigenschaft vorgenommenen Änderungen setzen die Einstellungen der Konfigurationsdatei außer Kraft.

Die SmtpClient -Klasse unterstützt nur die SMTP-Diensterweiterung für Secure SMTP over Transport Layer Security, wie in RFC 3207 definiert. In diesem Modus beginnt die SMTP-Sitzung in einem unverschlüsselten Kanal, dann wird vom Client ein STARTTLS-Befehl an den Server ausgegeben, um zur sicheren Kommunikation mithilfe von SSL zu wechseln. Weitere Informationen finden Sie unter RFC 3207, veröffentlicht von der Internet Engineering Task Force (IETF).

Bei einer alternativen Verbindungsmethode wird vorab eine SSL-Sitzung eingerichtet, bevor Protokollbefehle gesendet werden. Diese Verbindungsmethode wird manchmal als SMTP/SSL, SMTP über SSL oder SMTPS bezeichnet und verwendet standardmäßig Port 465. Diese alternative Verbindungsmethode mit SSL wird derzeit nicht unterstützt.

Sie können mit angeben ClientCertificates , welche Clientzertifikate zum Herstellen der SSL-Verbindung verwendet werden sollen. ServerCertificateValidationCallback Mit können Sie das vom SMTP-Server bereitgestellte Zertifikat ablehnen. Mit SecurityProtocol der -Eigenschaft können Sie die zu verwendende Version des SSL-Protokolls angeben.

Hinweis

Wenn die EnableSsl -Eigenschaft auf truefestgelegt ist und der SMTP-E-Mail-Server in der Antwort auf den EHLO-Befehl nicht STARTTLS angibt, löst ein Aufruf der Send -Methode oder SendAsync eine aus SmtpException.

Weitere Informationen

• SmtpSection
• SmtpNetworkElement
• EnableSsl
• <mailSettings-Element> (Netzwerkeinstellungen)
• <smtp-Element> (Netzwerkeinstellungen)
• <network-Element> (Netzwerkeinstellungen)