SmtpClient.UseDefaultCredentials SmtpClient.UseDefaultCredentials SmtpClient.UseDefaultCredentials SmtpClient.UseDefaultCredentials Property

Определение

Возвращает или задает значение Boolean, которое управляет отправкой учетных данных DefaultCredentials вместе с запросами.Gets or sets a Boolean value that controls whether the DefaultCredentials are sent with requests.

public:
 property bool UseDefaultCredentials { bool get(); void set(bool value); };
[set: System.MonoNotSupported("no DefaultCredential support in Mono")]
public bool UseDefaultCredentials { get; set; }
member this.UseDefaultCredentials : bool with get, set
Public Property UseDefaultCredentials As Boolean

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

Значение true, если используются учетные данные по умолчанию; в противном случае — значение false.true if the default credentials are used; otherwise false. Значение по умолчанию — false.The default value is false.

Исключения

Значение этого свойства нельзя изменить во время отправки электронной почты.You cannot change the value of this property when an email is being sent.

Примеры

В следующем примере кода показано использование этого свойства.The following code example demonstrates using this property.

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


public static void CreateTestMessage2(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;

    try {
	  client.Send(message);
	}  
	catch (Exception ex) {
	  Console.WriteLine("Exception caught in CreateTestMessage2(): {0}", 
                  ex.ToString() );			  
    }              
}

Комментарии

Для некоторых SMTP-серверов требуется проверка подлинности клиента до того, как сервер отправит сообщение электронной почты от своего имени.Some SMTP servers require that the client be authenticated before the server sends email on its behalf. Присвойте этому свойству true значение SmtpClient , если этот объект должен по запросу сервера выполнять проверку подлинности с использованием учетных данных по умолчанию текущего пользователя, вошедшего в систему.Set this property to true when this SmtpClient object should, if requested by the server, authenticate using the default credentials of the currently logged on user. Для клиентских приложений это предпочтительное поведение в большинстве сценариев.For client applications, this is the desired behavior in most scenarios.

Учетные данные также можно указать с помощью файлов конфигурации приложения и компьютера.Credentials information can also be specified using the application and machine configuration files. Дополнительные сведения см. в <разделе> элемент маилсеттингс (параметры сети).For more information, see <mailSettings> Element (Network Settings).

Если свойство имеет false, значение, значение, заданное в Credentials свойстве, будет использоваться для учетных данных при соединении с сервером. UseDefaultCredentialsIf the UseDefaultCredentials property is set to false, then the value set in the Credentials property will be used for the credentials when connecting to the server. Если свойство имеет false значение и Credentials свойство не задано, почта отправляется на сервер анонимно. UseDefaultCredentialsIf the UseDefaultCredentials property is set to false and the Credentials property has not been set, then mail is sent to the server anonymously.

Внимание!

При предоставлении учетных данных для обычной проверки подлинности они отправляются на сервер в виде открытого текста.If you provide credentials for basic authentication, they are sent to the server in clear text. Это может представлять проблемы безопасности, так как ваши учетные данные могут быть просмотрены, а затем использоваться другими.This can present a security issue because your credentials can be seen, and then used by others.

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