SmtpClient.Credentials Propriété

Définition

Espace de noms:

System.Net.Mail

Assembly:

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

ICredentialsByHost qui 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 message électronique est en cours d'envoi.

Exemples

L’exemple de code suivant montre comment définir les informations d’identification utilisées pour envoyer un e-mail.

static void CreateTestMessage1( String^ server, int port )
{
   String^ to = L"jane@contoso.com";
   String^ from = L"ben@contoso.com";
   String^ subject = L"Using the new SMTP client.";
   String^ body = L"Using this new feature, you can send an email message from an application very easily.";
   MailMessage^ message = gcnew MailMessage( from,to,subject,body );
   SmtpClient^ client = gcnew 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 );
   client->~SmtpClient();
}

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 envoie des e-mails en son nom. Pour utiliser vos informations d’identification réseau par défaut, vous pouvez définir sur UseDefaultCredentials au true lieu de définir cette propriété. 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 sur false et que la Credentials propriété n’a pas été définie, le courrier est envoyé au serveur de manière anonyme.

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

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