SmtpClient.EnableSsl Egenskap

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

Egenskapsvärde

true SmtpClient om använder SSL, annars . false Standardvärdet är false.

Exempel

I följande kodexempel upprättas en SSL-anslutning med SMTP-servern och anslutningen används för att skicka ett e-postmeddelande.

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

Kommentarer

Egenskapen EnableSsl anger om SSL används för att komma åt den angivna SMTP-e-postservern.

Standardvärdet för den här egenskapen kan också anges i en dator- eller programkonfigurationsfil. Ändringar som görs i EnableSsl egenskapen åsidosätter konfigurationsfilens inställningar.

Klassen SmtpClient stöder endast SMTP-tjänsttillägget för säker SMTP över Transport Layer Security enligt definitionen i RFC 3207. I det här läget börjar SMTP-sessionen på en okrypterad kanal och sedan utfärdas ett STARTTLS-kommando av klienten till servern för att växla till säker kommunikation med hjälp av SSL. Mer information finns i RFC 3207 publicerad av IETF (Internet Engineering Task Force).

En alternativ anslutningsmetod är där en SSL-session upprättas i förväg innan protokollkommandon skickas. Den här anslutningsmetoden kallas ibland SMTP/SSL, SMTP över SSL eller SMTPS och använder som standard port 465. Den här alternativa anslutningsmetoden med SSL stöds inte för närvarande.

Du kan använda ClientCertificates för att ange vilka klientcertifikat som ska användas för att upprätta SSL-anslutningen. Gör ServerCertificateValidationCallback att du kan avvisa certifikatet som tillhandahålls av SMTP-servern. Med SecurityProtocol egenskapen kan du ange vilken version av SSL-protokollet som ska användas.

Se även

• SmtpSection
• SmtpNetworkElement
• EnableSsl
• <mailSettings-element> (nätverksinställningar)
• <smtp-element> (nätverksinställningar)
• <nätverkselement> (nätverksinställningar)