SmtpClient.ClientCertificates Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt an, welche Zertifikate zum Herstellen der SSL (Secure Sockets Layer)-Verbindung verwendet werden sollen.
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.X509CertificateCollectionPublic ReadOnly Property ClientCertificates As X509CertificateCollectionEigenschaftswert
Eine X509CertificateCollection, die ein oder mehrere Clientzertifikate enthält. Der Standardwert wird von den E-Mail-Konfigurationsattributen in einer Konfigurationsdatei abgeleitet.
Beispiele
Im folgenden Codebeispiel wird eine SSL-Verbindung mit dem SMTP-Server hergestellt und die Verbindung zum Senden einer E-Mail verwendet.
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);
}
Hinweise
Clientzertifikate sind standardmäßig optional. Für die Serverkonfiguration kann es jedoch erforderlich sein, dass der Client im Rahmen der ersten Verbindungsaushandlung ein gültiges Zertifikat vorgibt.
Hinweis
Das Framework speichert SSL-Sitzungen während der Erstellung zwischen und versucht, nach Möglichkeit eine zwischengespeicherte Sitzung für eine neue Anforderung wiederzuverwenden. Beim Versuch, eine SSL-Sitzung wiederzuverwenden, verwendet das Framework das erste Element von ClientCertificates (sofern vorhanden) oder versucht, eine anonyme Sitzung wiederzuverwenden, wenn ClientCertificates leer ist.
