SmtpClient.Credentials Свойство

Определение

Пространство имен:

System.Net.Mail

Сборки:

netstandard.dll, System.Net.Mail.dll

Исходный код:

SmtpClient.cs

Возвращает или задает учетные данные, используемые для проверки подлинности отправителя.

public:
 property System::Net::ICredentialsByHost ^ Credentials { System::Net::ICredentialsByHost ^ get(); void set(System::Net::ICredentialsByHost ^ value); };

public System.Net.ICredentialsByHost? Credentials { get; set; }

member this.Credentials : System.Net.ICredentialsByHost with get, set

Public Property Credentials As ICredentialsByHost

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

ICredentialsByHost

Значение ICredentialsByHost , представляющее учетные данные, используемые для проверки подлинности, или null если учетные данные не указаны.

Исключения

InvalidOperationException

Вы не можете изменить значение этого свойства при отправке сообщения электронной почты.

Примеры

В следующем примере кода показано, как задать учетные данные, используемые для отправки сообщения электронной почты.

public static void CreateTestMessage1(string server, int port)
{
    string to = "jane@contoso.com";
    string from = "ben@contoso.com";
    string subject = "Using the new SMTP client.";
    string body = @"Using this new feature, you can send an email message from an application very easily.";
    MailMessage message = new MailMessage(from, to, subject, body);
    SmtpClient client = new SmtpClient(server, port);
    // Credentials are necessary if the server requires the client
    // to authenticate before it will send email on the client's behalf.
    client.Credentials = CredentialCache.DefaultNetworkCredentials;
    client.Send(message);
}

Комментарии

Для некоторых SMTP-серверов требуется, чтобы клиент прошел проверку подлинности перед отправкой электронной почты от имени сервера. Чтобы использовать учетные данные сети по умолчанию, можно задать UseDefaultCredentialstrue вместо настройки этого свойства. UseDefaultCredentials Если для свойства задано false, значение, указанное в Credentials свойстве, будет использоваться для учетных данных при подключении к серверу. UseDefaultCredentials Если для свойства задано false значение и Credentials свойство не задано, почта отправляется на сервер анонимно.

Сведения о учетных данных также можно указать с помощью файлов конфигурации приложения и компьютера. Дополнительные сведения см. в разделе< mailSettings Element (Network Settings>). Если сведения указаны с помощью Credentials свойства, эта информация переопределяет параметры файла конфигурации.

Предостережение

Если вы предоставляете учетные данные для базовой проверки подлинности, они отправляются на сервер в виде четкого текста. Это может представлять проблему безопасности, так как учетные данные можно просмотреть, а затем использовать другие пользователи.