SmtpClient.EnableSsl Vlastnost

Definice

Obor názvů:

System.Net.Mail

Sestavení:

System.Net.Mail.dll

Zdroj:

SmtpClient.cs

Určete, jestli se SmtpClient k šifrování připojení používá protokol SSL (Secure Sockets Layer).

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

Hodnota vlastnosti

Boolean

truepokud používá SmtpClient SSL, v opačném případě . false Výchozí formát je false.

Příklady

Následující příklad kódu naváže připojení SSL se serverem SMTP a použije připojení k odeslání e-mailu.

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

Poznámky

Vlastnost EnableSsl určuje, zda se pro přístup k zadanému poštovnímu serveru SMTP používá protokol SSL.

Výchozí hodnotu této vlastnosti lze také nastavit v konfiguračním souboru počítače nebo aplikace. Všechny změny provedené ve vlastnosti přepíší EnableSsl nastavení konfiguračního souboru.

Třída SmtpClient podporuje pouze rozšíření služby SMTP pro secure SMTP over Transport Layer Security definované v RFC 3207. V tomto režimu začíná relace SMTP na nešifrované kanálu a potom klient vydá na server příkaz STARTTLS, aby se přepnul na zabezpečenou komunikaci pomocí PROTOKOLU SSL. Další informace najdete v dokumentu RFC 3207 publikovaném internetem IETF (Internet Engineering Task Force).

Alternativní způsob připojení je, kdy se relace SSL vytvoří předem před odesláním příkazů protokolu. Tato metoda připojení se někdy nazývá SMTP/SSL, SMTP přes SSL nebo SMTPS a ve výchozím nastavení používá port 465. Tato alternativní metoda připojení používající PROTOKOL SSL se v současné době nepodporuje.

Pomocí příkazu ClientCertificates můžete určit, které klientské certifikáty se mají použít k navázání připojení SSL. Umožňuje ServerCertificateValidationCallback odmítnout certifikát poskytnutý serverem SMTP. Vlastnost SecurityProtocol umožňuje určit verzi protokolu SSL, která se má použít.

Poznámka

EnableSsl Pokud je vlastnost nastavena na truea poštovní server SMTP neinzeruje startTLS v odpovědi na příkaz EHLO, vyvolá volání Send metody nebo SendAsync metodu SmtpException.

Viz také

• SmtpSection
• SmtpNetworkElement
• EnableSsl
• <element mailSettings> (nastavení sítě)
• <smtp> – element (nastavení sítě)
• <network> – element (nastavení sítě)