SmtpClient.UseDefaultCredentials Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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é
true
si les informations d'identification par défaut sont utilisées ; sinon, false
. La valeur par défaut est false
.
Exceptions
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.