SmtpClient.EnableSsl Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Określ, SmtpClient czy do szyfrowania połączenia używa protokołu Secure Sockets Layer (SSL).
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 BooleanWartość właściwości
truejeśli używa protokołu SmtpClient SSL; w przeciwnym razie . false Wartość domyślna to false.
Przykłady
Poniższy przykład kodu ustanawia połączenie SSL z serwerem SMTP i używa połączenia do wysyłania wiadomości e-mail.
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);
}
Uwagi
Właściwość EnableSsl określa, czy protokół SSL jest używany do uzyskiwania dostępu do określonego serwera poczty SMTP.
Wartość domyślna tej właściwości można również ustawić w pliku konfiguracji maszyny lub aplikacji. Wszelkie zmiany wprowadzone we EnableSsl właściwości zastępują ustawienia pliku konfiguracji.
Klasa SmtpClient obsługuje tylko rozszerzenie usługi SMTP dla protokołu Secure SMTP over Transport Layer Security zgodnie z definicją w dokumencie RFC 3207. W tym trybie sesja SMTP rozpoczyna się w niezaszyfrowanym kanale, a następnie polecenie STARTTLS jest wydawane przez klienta do serwera, aby przełączyć się na bezpieczną komunikację przy użyciu protokołu SSL. Aby uzyskać więcej informacji, zobacz RFC 3207 opublikowane przez Internet Engineering Task Force (IETF).
Alternatywna metoda połączenia polega na tym, że sesja SSL jest ustanawiana z góry przed wysłaniem jakichkolwiek poleceń protokołu. Ta metoda połączenia jest czasami nazywana protokołem SMTP/SSL, SMTP za pośrednictwem protokołu SSL lub SMTPS, a domyślnie używa portu 465. Ta alternatywna metoda połączenia przy użyciu protokołu SSL nie jest obecnie obsługiwana.
Można użyć ClientCertificates polecenia , aby określić, które certyfikaty klienta powinny być używane do nawiązania połączenia SSL. Element ServerCertificateValidationCallback umożliwia odrzucenie certyfikatu dostarczonego przez serwer SMTP. Właściwość SecurityProtocol umożliwia określenie wersji protokołu SSL do użycia.
Uwaga
EnableSsl Jeśli właściwość jest ustawiona na truewartość , a serwer poczty SMTP nie anonsuje wartości STARTTLS w odpowiedzi na polecenie EHLO, wywołanie Send metody lub SendAsync zgłosi SmtpExceptionbłąd .
