SmtpClient.EnableSsl Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Určete, jestli 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, setPublic Property EnableSsl As BooleanHodnota vlastnosti
true
SmtpClient pokud používá protokol SSL, falsejinak . Výchozí hodnota je false.
Příklady
Následující příklad kódu vytvoří připojení SSL k serveru 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 nastavit také v konfiguračním souboru počítače nebo aplikace. Všechny změny provedené ve vlastnosti přepíší nastavení konfiguračního EnableSsl souboru.
Třída SmtpClient podporuje pouze rozšíření služby SMTP pro secure SMTP over Transport Layer Security, jak je definováno v RFC 3207. V tomto režimu začíná relace SMTP v nešifrovaném kanálu a pak klient vydá příkaz STARTTLS serveru, který přepne na zabezpečenou komunikaci pomocí PROTOKOLU SSL. Další informace najdete v dokumentu RFC 3207 publikovaném týmem IETF (Internet Engineering Task Force).
Alternativní metoda připojení je místo, kde je relace SSL vytvořena 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í využívající protokol SSL se v současné době nepodporuje.
Můžete použít ClientCertificates k určení, 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 zadat verzi protokolu SSL, který se má použít.
Poznámka:
Pokud je vlastnost nastavena EnableSsl na truea SMTP poštovní server neinzeruje STARTTLS v reakci na příkaz EHLO, volání Send metody nebo SendAsync metody vyvolá SmtpException.
