SmtpClient.UseDefaultCredentials Propriété

Définition

Espace de noms:

System.Net.Mail

Assembly:

System.Net.Mail.dll

Source:

SmtpClient.cs

Obtient ou définit une valeur Boolean qui contrôle si les DefaultCredentials sont envoyés avec les demandes.

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

Valeur de propriété

Boolean

true si les informations d'identification par défaut sont utilisées ; sinon, false. La valeur par défaut est false.

Exceptions

InvalidOperationException

Vous ne pouvez pas modifier la valeur de cette propriété lorsqu'un message électronique est en cours d'envoi.

Exemples

L’exemple de code suivant illustre l’utilisation de cette propriété.

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

Remarques

Certains serveurs SMTP nécessitent l’authentification du client avant que le serveur envoie des e-mails en son nom. Définissez cette propriété true sur quand cet SmtpClient objet doit, si le serveur le demande, s’authentifier à l’aide des informations d’identification par défaut de l’utilisateur actuellement connecté. Pour les applications clientes, il s’agit du comportement souhaité dans la plupart des scénarios.

Les informations d'identification peuvent également être spécifiées à l'aide des fichiers de configuration de l'application et de l'ordinateur. Pour plus d’informations, consultez <élément mailSettings> (paramètres réseau).

Si la UseDefaultCredentials propriété est définie sur false, , la valeur définie dans la Credentials propriété sera utilisée pour les informations d’identification lors de la connexion au serveur. Si la UseDefaultCredentials propriété est définie false sur et que la Credentials propriété n’a pas été définie, le courrier est envoyé au serveur de manière anonyme.

Attention

Si vous fournissez des informations d'identification pour l'authentification de base, elles sont envoyées au serveur en texte clair. Cela peut présenter un problème de sécurité, car vos informations d’identification peuvent être visibles, puis utilisées par d’autres personnes.