SmtpClient.Credentials Propriété

Définition

Espace de noms:

System.Net.Mail

Assemblys:

netstandard.dll, System.Net.Mail.dll

Source:

SmtpClient.cs

Obtient ou définit les informations d’identification utilisées pour authentifier l’expéditeur.

public:
 property System::Net::ICredentialsByHost ^ Credentials { System::Net::ICredentialsByHost ^ get(); void set(System::Net::ICredentialsByHost ^ value); };

public System.Net.ICredentialsByHost? Credentials { get; set; }

member this.Credentials : System.Net.ICredentialsByHost with get, set

Public Property Credentials As ICredentialsByHost

Valeur de propriété

ICredentialsByHost

Qui ICredentialsByHost représente les informations d’identification à utiliser pour l’authentification ; ou null si aucune information d’identification n’a été spécifiée.

Exceptions

InvalidOperationException

Vous ne pouvez pas modifier la valeur de cette propriété lorsqu’un e-mail est envoyé.

Exemples

L’exemple de code suivant illustre la définition des informations d’identification utilisées pour envoyer un e-mail.

public static void CreateTestMessage1(string server, int port)
{
    string to = "jane@contoso.com";
    string from = "ben@contoso.com";
    string subject = "Using the new SMTP client.";
    string body = @"Using this new feature, you can send an email message from an application very easily.";
    MailMessage message = new MailMessage(from, to, subject, body);
    SmtpClient client = new SmtpClient(server, port);
    // Credentials are necessary if the server requires the client
    // to authenticate before it will send email on the client's behalf.
    client.Credentials = CredentialCache.DefaultNetworkCredentials;
    client.Send(message);
}

Remarques

Certains serveurs SMTP nécessitent que le client soit authentifié avant que le serveur n’envoie un e-mail en son nom. Pour utiliser vos informations d’identification réseau par défaut, vous pouvez définir la UseDefaultCredentialstrue valeur à la place de la définition de cette propriété. Si la UseDefaultCredentials propriété est définie sur false, alors 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 et que la Credentials propriété n’a pas été définie, le courrier est envoyé anonymement au serveur.

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’élément mailSettings> (Paramètres réseau). Si des informations sont spécifiées à l’aide de la Credentials propriété, ces informations remplacent les paramètres du fichier de configuration.

Avertissement

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 sont visibles, puis utilisées par d’autres personnes.