SmtpClient.EnableSsl Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Geef op of ssl SmtpClient (Secure Sockets Layer) wordt gebruikt om de verbinding te versleutelen.
public:
property bool EnableSsl { bool get(); void set(bool value); };public bool EnableSsl { get; set; }member this.EnableSsl : bool with get, setPublic Property EnableSsl As BooleanWaarde van eigenschap
true als ssl SmtpClient wordt gebruikt; falseanders. De standaardwaarde is false.
Voorbeelden
In het volgende codevoorbeeld wordt een SSL-verbinding met de SMTP-server tot stand gebracht en wordt de verbinding gebruikt om een e-mailbericht te verzenden.
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);
}
Opmerkingen
De EnableSsl eigenschap geeft aan of SSL wordt gebruikt voor toegang tot de opgegeven SMTP-e-mailserver.
De standaardwaarde voor deze eigenschap kan ook worden ingesteld in een computer- of toepassingsconfiguratiebestand. Wijzigingen die zijn aangebracht in de EnableSsl eigenschap overschrijven de instellingen van het configuratiebestand.
De SmtpClient klasse ondersteunt alleen de SMTP-serviceextensie voor secure SMTP via Transport Layer Security, zoals gedefinieerd in RFC 3207. In deze modus begint de SMTP-sessie op een niet-versleuteld kanaal en wordt er door de client een STARTTLS-opdracht uitgegeven om over te schakelen naar beveiligde communicatie via SSL. Zie RFC 3207 gepubliceerd door de Internet Engineering Task Force (IETF) voor meer informatie.
Een alternatieve verbindingsmethode is de plek waar een SSL-sessie vooraf tot stand wordt gebracht voordat protocolopdrachten worden verzonden. Deze verbindingsmethode wordt ook wel SMTP/SSL, SMTP via SSL of SMTPS genoemd en maakt standaard gebruik van poort 465. Deze alternatieve verbindingsmethode met SSL wordt momenteel niet ondersteund.
U kunt gebruiken ClientCertificates om op te geven welke clientcertificaten moeten worden gebruikt om de SSL-verbinding tot stand te brengen. Hiermee ServerCertificateValidationCallback kunt u het certificaat van de SMTP-server weigeren. Met SecurityProtocol de eigenschap kunt u de versie van het SSL-protocol opgeven die moet worden gebruikt.
Note
Als de EnableSsl eigenschap is ingesteld op true, en de SMTP-e-mailserver geen STARTTLS adverteren in het antwoord op de EHLO-opdracht, genereert een aanroep naar de Send of SendAsync methoden een SmtpException.