SmtpClient.ClientCertificates Eigenschaft

Definition

Namespace:

System.Net.Mail

Assembly:

System.Net.Mail.dll

Quelle:

SmtpClient.cs

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.X509CertificateCollection

Public ReadOnly Property ClientCertificates As X509CertificateCollection

Eigenschaftswert

X509CertificateCollection

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.

Weitere Informationen

• MailSettings-Element (Netzwerkeinstellungen)