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

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