SmtpClient.ClientCertificates Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Spécifiez les certificats à utiliser pour établir la connexion 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.X509CertificateCollectionPublic ReadOnly Property ClientCertificates As X509CertificateCollectionValeur de propriété
Un X509CertificateCollection, contenant un ou plusieurs certificats clients. La valeur par défaut est dérivée des attributs de configuration de messagerie dans un fichier de configuration.
Exemples
L’exemple de code suivant établit une connexion SSL avec le serveur SMTP et utilise la connexion pour envoyer un 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);
}
Remarques
Les certificats clients sont, par défaut, facultatifs ; Toutefois, la configuration du serveur peut exiger que le client présente un certificat valide dans le cadre de la négociation de connexion initiale.
La modification de cette collection n’invalide pas une connexion SMTP mise en cache existante ou déclenche une nouvelle négociation TLS. Si une connexion est réutilisée, elle continue d’utiliser le contexte de sécurité établi lors de sa création. Pour utiliser un contexte de sécurité ou d’identité différent, supprimez et SmtpClient créez une instance. Ou, pour forcer une nouvelle connexion et une liaison, modifiez une propriété qui invalide la connexion mise en cache.
Note
Framework met en cache les sessions SSL au fur et à mesure qu’elles sont créées et tente de réutiliser une session mise en cache pour une nouvelle requête, si possible. Lorsque vous tentez de réutiliser une session SSL, l’infrastructure utilise le premier élément de ClientCertificates (s’il en existe un) ou tente de réutiliser une session anonyme si ClientCertificates elle est vide.
