SmtpClient.ClientCertificates 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, które certyfikaty mają być używane do ustanawiania połączenia Secure Sockets Layer (SSL).
public:
property System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ ClientCertificates { System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ get(); };
public System.Security.Cryptography.X509Certificates.X509CertificateCollection ClientCertificates { get; }
member this.ClientCertificates : System.Security.Cryptography.X509Certificates.X509CertificateCollection
Public ReadOnly Property ClientCertificates As X509CertificateCollection
Wartość właściwości
Element X509CertificateCollection, przechowujący co najmniej jeden certyfikat klienta. Wartość domyślna pochodzi z atrybutów konfiguracji poczty w pliku konfiguracji.
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
Certyfikaty klienta są domyślnie opcjonalne; jednak konfiguracja serwera może wymagać, aby klient przedstawił prawidłowy certyfikat w ramach początkowych negocjacji połączenia.
Uwaga
Platforma buforuje sesje SSL podczas ich tworzenia i próbuje ponownie użyć sesji buforowanej dla nowego żądania, jeśli to możliwe. Podczas próby ponownego użycia sesji SSL struktura używa pierwszego elementu ClientCertificates (jeśli istnieje) lub próbuje ponownie użyć sesji anonimowych, jeśli ClientCertificates jest pusta.