SmtpClient.UseDefaultCredentials Propriedade

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

Valor de Propriedade

true se forem usadas as credenciais padrão; caso contrário false. O valor predefinido é false.

Exceções

Exemplos

O exemplo de código seguinte demonstra o uso desta propriedade.

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());
    }
}

Observações

Alguns servidores SMTP exigem que o cliente seja autenticado antes de enviar emails em seu nome. Defina esta propriedade para true quando este SmtpClient objeto deve, se solicitado pelo servidor, autenticar-se usando as credenciais padrão do utilizador atualmente iniciado. Para aplicações cliente, este é o comportamento desejado na maioria dos cenários.

A informação das credenciais também pode ser especificada usando os ficheiros de configuração da aplicação e da máquina. Para mais informações, consulte <Elemento mailSettings> (Configurações de Rede).

Se a UseDefaultCredentials propriedade estiver definida para false, então o conjunto de valores na Credentials propriedade será usado para as credenciais ao ligar-se ao servidor. Se a UseDefaultCredentials propriedade estiver definida como false e a Credentials propriedade não tiver sido definida, então o correio é enviado para o servidor anonimamente.