SmtpClient.ClientCertificates Propriedade

Definição

Especifique quais certificados devem ser usados para estabelecer a conexão do protocolo SSL.Specify which certificates should be used to establish the Secure Sockets Layer (SSL) connection.

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.An X509CertificateCollection, holding one or more client certificates. O valor padrão é derivado dos atributos de configuração do email em um arquivo de configuração.The default value is derived from the mail configuration attributes in a configuration file.

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.The following code example establishes an SSL connection with the SMTP server and uses the connection to send an 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 de 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.Client certificates are, by default, optional; however, the server configuration might require that the client present a valid certificate as part of the initial connection negotiation.

Observação

A estrutura armazena em cache as 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.The Framework caches SSL sessions as they are created and attempts to reuse a cached session for a new request, if possible. Ao tentar reutilizar uma sessão SSL, a estrutura usa o primeiro elemento de ClientCertificates (se houver) ou tenta reutilizar as sessões anônimas se o ClientCertificates estiver vazio.When attempting to reuse an SSL session, the Framework uses the first element of ClientCertificates (if there is one), or tries to reuse an anonymous sessions if ClientCertificates is empty.

Aplica-se a