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 Änderungen an der EnableSsl Eigenschaft überschreiben die Konfigurationsdateieinstellungen.

Die SmtpClient-Klasse unterstützt nur die SMTP-Diensterweiterung für SMTPS über TLS, wie in RFC 3207 definiert. In diesem Modus beginnt die SMTP-Sitzung in einem unverschlüsselten Kanal. Anschließend wird vom Client ein STARTTLS-Befehl an den Server gesendet, um zur sicheren Kommunikation über SSL zu wechseln. Weitere Informationen finden Sie in der RFC 3207, die von der Internet Engineering Task Force (IETF) veröffentlicht wird.

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 verwenden ClientCertificates , um anzugeben, welche Clientzertifikate zum Herstellen der SSL-Verbindung verwendet werden sollen. Mit ServerCertificateValidationCallback 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)