SmtpClient.ClientCertificates Vlastnost

Definice

Obor názvů:

System.Net.Mail

Sestavení:

netstandard.dll, System.Net.Mail.dll

Zdroj:

SmtpClient.cs

Určete, které certifikáty se mají použít k navázání připojení SSL (Secure Sockets Layer).

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

Hodnota vlastnosti

X509CertificateCollection

A X509CertificateCollection, držící jeden nebo více klientských certifikátů. Výchozí hodnota je odvozena z atributů konfigurace pošty v konfiguračním souboru.

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

Klientské certifikáty jsou ve výchozím nastavení volitelné; Konfigurace serveru však může vyžadovat, aby klient v rámci počátečního vyjednávání připojení předložil platný certifikát.

Úprava této kolekce zneplatní stávající připojení SMTP uložené v mezipaměti ani neaktivuje nové metody handshake protokolu TLS. Pokud se připojení znovu použije, bude nadále používat kontext zabezpečení vytvořený při jeho vytvoření. Pokud chcete použít jiný kontext zabezpečení nebo identity, odstraňte SmtpClient a vytvořte novou instanci. Pokud chcete vynutit nové připojení a metodu handshake, změňte vlastnost, která zneplatňuje připojení uložené v mezipaměti.

Note

Rozhraní ukládá relace SSL do mezipaměti při jejich vytváření a pokud je to možné, pokusí se znovu použít relaci uloženou v mezipaměti pro nový požadavek. Při pokusu o opakované použití relace SSL používá framework první prvek ClientCertificates (pokud existuje) nebo se pokusí znovu použít anonymní relace, pokud ClientCertificates je prázdný.

Viz také

• Element MailSettings (nastavení sítě)