SmtpClient.Credentials Свойство

Определение

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

System.Net.Mail

Сборка:

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

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

Примеры

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

static void CreateTestMessage1( String^ server, int port )
{
   String^ to = L"jane@contoso.com";
   String^ from = L"ben@contoso.com";
   String^ subject = L"Using the new SMTP client.";
   String^ body = L"Using this new feature, you can send an email message from an application very easily.";
   MailMessage^ message = gcnew MailMessage( from,to,subject,body );
   SmtpClient^ client = gcnew 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 );
   client->~SmtpClient();
}

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> (параметры сети). Если сведения указываются с помощью Credentials свойства , эти сведения переопределяют параметры файла конфигурации.

Внимание!

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