SmtpClient.Send Méthode

Définition

Espace de noms:

System.Net.Mail

Assemblys:

netstandard.dll, System.Net.Mail.dll

Envoie un e-mail à un serveur SMTP pour la remise. Ces méthodes bloquent la transmission du message.

Surcharges

Nom	Description
Send(MailMessage)	Envoie le message spécifié à un serveur SMTP pour la remise.
Send(String, String, String, String)	Envoie le message électronique spécifié à un serveur SMTP pour la remise. L’expéditeur du message, les destinataires, l’objet et le corps du message sont spécifiés à l’aide d’objets String .

Send(MailMessage)

Source:

SmtpClient.cs

Envoie le message spécifié à un serveur SMTP pour la remise.

public:
 void Send(System::Net::Mail::MailMessage ^ message);

public void Send(System.Net.Mail.MailMessage message);

member this.Send : System.Net.Mail.MailMessage -> unit

Public Sub Send (message As MailMessage)

Paramètres

message

MailMessage

Qui MailMessage contient le message à envoyer.

Exceptions

ArgumentNullException

message a la valeur null.

InvalidOperationException

Une SmtpClient autre opération d’envoi est déjà en cours.

- ou -

From a la valeur null.

- ou -

Il n’y a pas de destinataires spécifiés dans To, CCet Bcc les propriétés.

- ou -

DeliveryMethod la propriété est définie Network sur et Host est null.

- ou -

DeliveryMethod la propriété est définie Network sur et Host est égale à la chaîne vide ( » « ).

- ou -

DeliveryMethod la propriété est définie Network sur zéro Port , un nombre négatif ou supérieur à 65 535.

ObjectDisposedException

Cet objet a été supprimé.

SmtpException

Échec de la connexion au serveur SMTP.

- ou -

Échec de l’authentification.

- ou -

L’opération a expiré.

- ou -

EnableSsl est défini sur true mais la DeliveryMethod propriété est définie sur SpecifiedPickupDirectory ou PickupDirectoryFromIis.

- ou -

EnableSsl est défini sur true, mais le serveur de messagerie SMTP n’a pas publié STARTTLS dans la réponse à la commande EHLO.

SmtpFailedRecipientException

Impossible message de remettre l’un des destinataires dans To, CCou Bcc.

SmtpFailedRecipientsException

Impossible message de remettre au moins deux destinataires dans To, CCou Bcc.

Exemples

L’exemple de code suivant illustre l’utilisation de cette méthode.

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

Cette méthode bloque la transmission de l’e-mail. Vous pouvez spécifier une valeur de délai d’attente à l’aide de la Timeout propriété pour vous assurer que la méthode retourne après un délai spécifié.

Avant d’appeler cette méthode, les HostPort propriétés doivent être définies via les fichiers de configuration en définissant les propriétés appropriées ou en transmettant ces informations au SmtpClient(String, Int32) constructeur.

Vous ne pouvez pas appeler cette méthode en cas d’envoi asynchrone d’un message.

Si l’hôte SMTP nécessite des informations d’identification, vous devez les définir avant d’appeler cette méthode. Pour spécifier des informations d’identification, utilisez le ou Credentials les UseDefaultCredentials propriétés.

Si vous recevez une SmtpException exception, vérifiez la StatusCode propriété pour trouver la raison pour laquelle l’opération a échoué. Il SmtpException peut également contenir une exception interne qui indique la raison pour laquelle l’opération a échoué.

Lors de l’envoi d’e-mails à plusieurs destinataires et que le serveur SMTP accepte certains destinataires comme valides et rejette d’autres, Send envoie un e-mail Send aux destinataires acceptés, puis un SmtpFailedRecipientsException message est levée (ou si SmtpFailedRecipientException un seul destinataire est rejeté). Un SmtpFailedRecipientsException contient une liste des destinataires qui ont été rejetés.

Note

Si la EnableSsl propriété est définie truesur , et que le serveur de messagerie SMTP ne publie pas STARTTLS dans la réponse à la commande EHLO, un appel à l’ou SendSendAsync aux méthodes lève un SmtpException.

Send(String, String, String, String)

Source:

SmtpClient.cs

Envoie le message électronique spécifié à un serveur SMTP pour la remise. L’expéditeur du message, les destinataires, l’objet et le corps du message sont spécifiés à l’aide d’objets String .

public:
 void Send(System::String ^ from, System::String ^ recipients, System::String ^ subject, System::String ^ body);

public void Send(string from, string recipients, string? subject, string? body);

member this.Send : string * string * string * string -> unit

Public Sub Send (from As String, recipients As String, subject As String, body As String)

Paramètres

from

String

Qui String contient les informations d’adresse de l’expéditeur du message.

recipients

String

Qui String contient les adresses auxquelles le message est envoyé.

subject

String

Qui String contient la ligne d’objet du message.

body

String

Qui String contient le corps du message.

Exceptions

ArgumentNullException

from a la valeur null.

- ou -

recipients a la valeur null.

ArgumentException

from a la valeur Empty.

- ou -

recipients a la valeur Empty.

InvalidOperationException

Une SmtpClient autre opération d’envoi est déjà en cours.

- ou -

DeliveryMethod la propriété est définie Network sur et Host est null.

- ou -

DeliveryMethod la propriété est définie Network sur et Host est égale à la chaîne vide ( » « ).

- ou -

DeliveryMethod la propriété est définie Network sur zéro Port , un nombre négatif ou supérieur à 65 535.

ObjectDisposedException

Cet objet a été supprimé.

SmtpException

Échec de la connexion au serveur SMTP.

- ou -

Échec de l’authentification.

- ou -

L’opération a expiré.

- ou -

EnableSsl est défini sur true mais la DeliveryMethod propriété est définie sur SpecifiedPickupDirectory ou PickupDirectoryFromIis.

- ou -

EnableSsl est défini sur true, mais le serveur de messagerie SMTP n’a pas publié STARTTLS dans la réponse à la commande EHLO.

SmtpFailedRecipientException

Le message n’a pas pu être remis à l’un des destinataires dans To, CCou Bcc.

SmtpFailedRecipientsException

Le message n’a pas pu être remis à deux destinataires ou plus dans To, CCou Bcc.

Remarques

Cette méthode bloque la transmission de l’e-mail. Vous pouvez spécifier une valeur de délai d’attente à l’aide de la Timeout propriété pour vous assurer que la méthode retourne après un délai spécifié.

Avant d’appeler cette méthode, les HostPort propriétés doivent être définies via les fichiers de configuration en définissant les propriétés appropriées ou en transmettant ces informations au SmtpClient(String, Int32) constructeur.

Vous ne pouvez pas appeler cette méthode en cas d’envoi asynchrone d’un message.

Si l’hôte SMTP nécessite des informations d’identification, vous devez les définir avant d’appeler cette méthode. Pour spécifier des informations d’identification, utilisez le ou Credentials les UseDefaultCredentials propriétés.

Si vous recevez une SmtpException exception, vérifiez la StatusCode propriété pour trouver la raison pour laquelle l’opération a échoué. Il SmtpException peut également contenir une exception interne qui indique la raison pour laquelle l’opération a échoué.

Lors de l’envoi d’e-mails à plusieurs destinataires et que le serveur SMTP accepte certains destinataires comme valides et rejette d’autres, Send envoie un e-mail Send aux destinataires acceptés, puis un SmtpFailedRecipientsException message est levée (ou si SmtpFailedRecipientException un seul destinataire est rejeté). Un SmtpFailedRecipientsException contient une liste des destinataires qui ont été rejetés.

Note

Si la EnableSsl propriété est définie truesur , et que le serveur de messagerie SMTP ne publie pas STARTTLS dans la réponse à la commande EHLO, un appel à l’ou SendSendAsync aux méthodes lève un SmtpException.