SmtpClient.ClientCertificates Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Especifique quais os certificados que devem ser usados para estabelecer a ligação Secure Sockets Layer (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.X509CertificateCollectionPublic ReadOnly Property ClientCertificates As X509CertificateCollectionValor de Propriedade
Um , detendo X509CertificateCollectionum ou mais certificados de clientes. O valor predefinido é derivado dos atributos de configuração do correio num ficheiro de configuração.
Exemplos
O exemplo de código seguinte estabelece uma ligação SSL com o servidor SMTP e utiliza essa ligaçã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);
}
Observações
Os certificados de cliente são, por defeito, opcionais; no entanto, a configuração do servidor pode exigir que o cliente apresente um certificado válido como parte da negociação inicial da ligação.
Modificar esta coleção não invalida uma ligação SMTP em cache existente nem desencadeia um novo handshake TLS. Se uma ligação for reutilizada, continua a usar o contexto de segurança estabelecido quando foi criada. Para usar um contexto de segurança ou identidade diferente, elimine o SmtpClient e crie uma nova instância. Ou, para forçar uma nova ligação e aperto de mão, alterar uma propriedade que invalide a ligação em cache.
Note
O Framework armazena em cache as sessões SSL à medida que são criadas e tenta reutilizar uma sessão em cache para um novo pedido, se possível. Ao tentar reutilizar uma sessão SSL, o Framework utiliza o primeiro elemento de ClientCertificates (se existir), ou tenta reutilizar uma sessão anónima se ClientCertificates estiver vazio.
