SmtpClient.ClientCertificates Propriedade

  • Referência

Definição

Namespace:
System.Net.Mail
Assembly:
System.Net.Mail.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Especifique quais certificados devem ser usados para estabelecer a conexão do protocolo 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

Valor da propriedade

X509CertificateCollection

Um X509CertificateCollection, que contém um ou mais certificados do cliente. O valor padrão é derivado dos atributos de configuração do email em um arquivo de configuração.

Exemplos

O exemplo de código a seguir estabelece uma conexão SSL com o servidor SMTP e usa a conexão para enviar um email.

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);
}

Comentários

Os certificados do cliente são, por padrão, opcionais; no entanto, a configuração do servidor pode exigir que o cliente apresente um certificado válido como parte da negociação de conexão inicial.

Observação

A Estrutura armazena em cache sessões SSL conforme elas são criadas e tenta reutilizar uma sessão armazenada em cache para uma nova solicitação, se possível. Ao tentar reutilizar uma sessão SSL, o Framework usa o primeiro elemento de ClientCertificates (se houver um) ou tenta reutilizar uma sessão anônima se ClientCertificates estiver vazio.

Aplica-se a

Confira também