SmtpClient.Credentials Свойство

Определение

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

public:
 property System::Net::ICredentialsByHost ^ Credentials { System::Net::ICredentialsByHost ^ get(); void set(System::Net::ICredentialsByHost ^ value); };
public System.Net.ICredentialsByHost? Credentials { get; set; }
public System.Net.ICredentialsByHost Credentials { get; set; }
member this.Credentials : System.Net.ICredentialsByHost with get, set
Public Property Credentials As ICredentialsByHost

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

ICredentialsByHost

Объект ICredentialsByHost, представляющий учетные данные для проверки подлинности; или значение null, если учетные данные не указаны.

Исключения

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

Примеры

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

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;
   
   //Display the properties on the service point.
   ServicePoint^ p = client->ServicePoint;
   Console::WriteLine( L"Connection lease timeout: {0}", p->ConnectionLeaseTimeout );
   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-серверов требуется, чтобы клиент прошел проверку подлинности, прежде чем сервер отправит сообщение электронной почты от его имени. Чтобы использовать сетевые учетные данные по умолчанию, можно задать значение UseDefaultCredentials true вместо установки этого свойства. UseDefaultCredentials Если свойству false, присвоено значение, заданное в свойствеCredentials, будет использоваться для учетных данных при подключении к серверу. UseDefaultCredentials Если свойство задано false и Credentials свойство не задано, почта отправляется на сервер анонимно.

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

Внимание!

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

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