SmtpClient.ClientCertificates Свойство

Определение

Указывает, какие сертификаты следует использовать для установки 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

Значение свойства

X509CertificateCollection

Объект X509CertificateCollection, содержащий один или несколько клиентских сертификатов.An X509CertificateCollection, holding one or more client certificates. Значение по умолчанию выводится на основе атрибутов конфигурации почты из файла конфигурации.The default value is derived from the mail configuration attributes in a configuration file.

Примеры

В следующем примере кода устанавливается подключение SSL к SMTP-серверу и используется подключение для отправки сообщения электронной почты.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);
}

Комментарии

Сертификаты клиента по умолчанию являются необязательными; Однако конфигурация сервера может потребовать, чтобы клиент представлю действительный сертификат в рамках первоначального согласования подключения.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.

Примечание

Платформа кэширует сеансы SSL по мере их создания и пытается повторно использовать кэшированный сеанс для нового запроса, если это возможно.The Framework caches SSL sessions as they are created and attempts to reuse a cached session for a new request, if possible. При попытке повторного использования сеанса SSL платформа использует первый элемент ClientCertificates (если таковой имеется) или пытается повторно использовать анонимные сеансы, если ClientCertificates параметр пуст.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.

Применяется к