SmtpClient.UseDefaultCredentials Propriedade
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define um valor Boolean que controla se o DefaultCredentials é enviado com solicitações.
public:
property bool UseDefaultCredentials { bool get(); void set(bool value); };
public bool UseDefaultCredentials { get; set; }
member this.UseDefaultCredentials : bool with get, set
Public Property UseDefaultCredentials As Boolean
true
se as credenciais padrão forem usadas; caso contrário, false
. O valor padrão é false
.
Não será possível alterar o valor dessa propriedade quando um email estiver sendo enviado.
O exemplo de código a seguir demonstra o uso dessa propriedade.
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());
}
}
Alguns servidores SMTP exigem que o cliente seja autenticado antes que o servidor envie emails em seu nome. Defina essa propriedade true
como quando esse SmtpClient objeto deve, se solicitado pelo servidor, autenticar usando as credenciais padrão do usuário conectado no momento. Para aplicativos cliente, esse é o comportamento desejado na maioria dos cenários.
As informações de credenciais também podem ser especificadas usando os arquivos de configuração do computador e do aplicativo. Para obter mais informações, consulte <Elemento mailSettings> (Configurações de Rede).
Se a UseDefaultCredentials propriedade for definida como false,
, o valor definido na Credentials propriedade será usado para as credenciais ao se conectar ao servidor. Se a UseDefaultCredentials propriedade estiver definida false
como e a Credentials propriedade não tiver sido definida, o email será enviado ao servidor anonimamente.
Atenção
Se forem fornecidas credenciais para autenticação básica, elas são enviadas para o servidor em texto não criptografado. Isso pode apresentar um problema de segurança porque suas credenciais podem ser vistas e usadas por outras pessoas.
Produto | Versões |
---|---|
.NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
Comentários do .NET
O .NET é um projeto código aberto. Selecione um link para fornecer comentários: