SmtpClient.SendMailAsync Méthode

Référence

Définition

Espace de noms:: System.Net.Mail

Assembly:: System.Net.Mail.dll

Assembly:: System.dll

Assembly:: netstandard.dll

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.

Envoie le message spécifié à un serveur SMTP pour remise en tant qu'opération asynchrone.

Surcharges

SendMailAsync(MailMessage)	Envoie le message spécifié à un serveur SMTP pour remise en tant qu'opération asynchrone.
SendMailAsync(MailMessage, CancellationToken)	Envoie le message spécifié à un serveur SMTP pour remise en tant qu'opération asynchrone.
SendMailAsync(String, String, String, String)	Envoie le message spécifié à un serveur SMTP pour remise en tant qu'opération asynchrone. L'expéditeur, les destinataires, l'objet et le corps du message sont spécifiés à l'aide d'objets String.
SendMailAsync(String, String, String, String, CancellationToken)	Envoie le message spécifié à un serveur SMTP pour qu’il soit remis en tant qu’opération asynchrone à l’aide de l’expéditeur, des destinataires, de l’objet et des chaînes de corps spécifiés.

SendMailAsync(MailMessage)

Source:: SmtpClient.cs

Source:: SmtpClient.cs

Source:: SmtpClient.cs

Envoie le message spécifié à un serveur SMTP pour remise en tant qu'opération asynchrone.

public:
 System::Threading::Tasks::Task ^ SendMailAsync(System::Net::Mail::MailMessage ^ message);

public System.Threading.Tasks.Task SendMailAsync (System.Net.Mail.MailMessage message);

member this.SendMailAsync : System.Net.Mail.MailMessage -> System.Threading.Tasks.Task

Public Function SendMailAsync (message As MailMessage) As Task

Paramètres

message: MailMessage

MailMessage qui contient le message à envoyer.

Retours

Task

Objet de tâche représentant l'opération asynchrone.

Exceptions

ArgumentNullException

message a la valeur null.

InvalidOperationException

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

- ou -

Il n'y a pas de destinataires spécifiés dans les propriétés To, CC et Bcc.

- ou -

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

- ou -

La propriété DeliveryMethod est définie sur Network et Host est égal à la chaîne vide ("").

- ou -

La propriété DeliveryMethod a la valeur Network et la valeur de Port est zéro, un nombre négatif ou un nombre supérieur à 65 535.

ObjectDisposedException

Cet objet a été supprimé.

SmtpException

La connexion au serveur SMTP a échoué.

- ou -

Échec de l'authentification.

- ou -

L'opération a expiré.

- ou -

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

- ou -

EnableSsl a la valeur true, mais le serveur de messagerie SMTP n'a pas publié STARTTLS dans la réponse à la commande EHLO.

- ou -

Le message n'a pas pu être remis à l'un ou plusieurs des destinataires dans To, CC ou Bcc.

SmtpFailedRecipientException

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

SmtpFailedRecipientsException

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

Remarques

Cette opération ne se bloque pas. L’objet retourné Task se termine une fois que le message a été envoyé.

S’applique à

SendMailAsync(MailMessage, CancellationToken)

Source:: SmtpClient.cs

Source:: SmtpClient.cs

Source:: SmtpClient.cs

Envoie le message spécifié à un serveur SMTP pour remise en tant qu'opération asynchrone.

public:
 System::Threading::Tasks::Task ^ SendMailAsync(System::Net::Mail::MailMessage ^ message, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task SendMailAsync (System.Net.Mail.MailMessage message, System.Threading.CancellationToken cancellationToken);

member this.SendMailAsync : System.Net.Mail.MailMessage * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function SendMailAsync (message As MailMessage, cancellationToken As CancellationToken) As Task

Paramètres

message: MailMessage

Message à envoyer.

cancellationToken: CancellationToken

Jeton d’annulation pour annuler l’opération.

Retours

Task

Objet de tâche représentant l'opération asynchrone.

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 les propriétés To, CC et Bcc.

- ou -

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

- ou -

La propriété DeliveryMethod est définie sur Network et Host est égal à la chaîne vide ("").

- ou -

La propriété DeliveryMethod a la valeur Network et la valeur de Port est zéro, un nombre négatif ou un nombre supérieur à 65 535.

ObjectDisposedException

Cet objet a été supprimé.

SmtpException

La connexion au serveur SMTP a échoué.

- ou -

Échec de l'authentification.

- ou -

L'opération a expiré.

- ou -

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

- ou -

EnableSsl a la valeur true, mais le serveur de messagerie SMTP n'a pas publié STARTTLS dans la réponse à la commande EHLO.

- ou -

Le message n'a pas pu être remis à l'un ou plusieurs des destinataires dans To, CC ou Bcc.

SmtpFailedRecipientException

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

SmtpFailedRecipientsException

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

OperationCanceledException

Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.

Remarques

Cette opération ne se bloque pas. L’objet retourné Task se termine une fois que le message a été envoyé.

S’applique à

SendMailAsync(String, String, String, String)

Source:: SmtpClient.cs

Source:: SmtpClient.cs

Source:: SmtpClient.cs

Envoie le message spécifié à un serveur SMTP pour remise en tant qu'opération asynchrone. L'expéditeur, les destinataires, l'objet et le corps du message sont spécifiés à l'aide d'objets String.

public:
 System::Threading::Tasks::Task ^ SendMailAsync(System::String ^ from, System::String ^ recipients, System::String ^ subject, System::String ^ body);

public System.Threading.Tasks.Task SendMailAsync (string from, string recipients, string? subject, string? body);

public System.Threading.Tasks.Task SendMailAsync (string from, string recipients, string subject, string body);

member this.SendMailAsync : string * string * string * string -> System.Threading.Tasks.Task

Public Function SendMailAsync (from As String, recipients As String, subject As String, body As String) As Task

Paramètres

from: String

String qui contient les informations d'adresse de l'expéditeur du message.

recipients: String

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

subject: String

String qui contient la ligne d'objet du message.

body: String

String qui contient le corps du message.

Retours

Task

Objet de tâche représentant l'opération asynchrone.

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-

From a la valeur null.

- ou -

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

- ou -

La propriété DeliveryMethod est définie sur Network et Host est égal à la chaîne vide ("").

- ou -

La propriété DeliveryMethod a la valeur Network et la valeur de Port est zéro, un nombre négatif ou un nombre supérieur à 65 535.

ObjectDisposedException

Cet objet a été supprimé.

SmtpException

La connexion au serveur SMTP a échoué.

- ou -

Échec de l'authentification.

- ou -

L'opération a expiré.

- ou -

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

- ou -

EnableSsl a la valeur true, mais le serveur de messagerie SMTP n'a pas publié STARTTLS dans la réponse à la commande EHLO.

- ou -

Le message n'a pas pu être remis à l'un ou plusieurs des destinataires dans To, CC ou Bcc.

SmtpFailedRecipientException

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

SmtpFailedRecipientsException

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

Remarques

Cette opération ne se bloque pas. L’objet retourné Task se termine une fois que le message a été envoyé.

S’applique à

SendMailAsync(String, String, String, String, CancellationToken)

Source:: SmtpClient.cs

Source:: SmtpClient.cs

Source:: SmtpClient.cs

Envoie le message spécifié à un serveur SMTP pour qu’il soit remis en tant qu’opération asynchrone à l’aide de l’expéditeur, des destinataires, de l’objet et des chaînes de corps spécifiés.

public:
 System::Threading::Tasks::Task ^ SendMailAsync(System::String ^ from, System::String ^ recipients, System::String ^ subject, System::String ^ body, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task SendMailAsync (string from, string recipients, string? subject, string? body, System.Threading.CancellationToken cancellationToken);

member this.SendMailAsync : string * string * string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function SendMailAsync (from As String, recipients As String, subject As String, body As String, cancellationToken As CancellationToken) As Task

Paramètres

from: String

Informations d’adresse de l’expéditeur du message.

recipients: String

Adresses auxquelles le message est envoyé.

subject: String

Ligne d’objet du message.

body: String

Corps du message.

cancellationToken: CancellationToken

Jeton d’annulation pour annuler l’opération.

Retours

Task

Objet de tâche représentant l'opération asynchrone.

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 -

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

- ou -

La propriété DeliveryMethod est définie sur Network et Host est égal à la chaîne vide ("").

- ou -

La propriété DeliveryMethod a la valeur Network et la valeur de Port est zéro, un nombre négatif ou un nombre supérieur à 65 535.

ObjectDisposedException

Cet objet a été supprimé.

SmtpException

La connexion au serveur SMTP a échoué.

- ou -

Échec de l'authentification.

- ou -

L'opération a expiré.

- ou -

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

- ou -

EnableSsl a la valeur true, mais le serveur de messagerie SMTP n'a pas publié STARTTLS dans la réponse à la commande EHLO.

- ou -

Le message n'a pas pu être remis à l'un ou plusieurs des destinataires dans To, CC ou Bcc.

SmtpFailedRecipientException

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

SmtpFailedRecipientsException

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

OperationCanceledException

Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.

Remarques

Cette opération ne se bloque pas. L’objet retourné Task se termine une fois que le message a été envoyé.

S’applique à

Partage via

SmtpClient.SendMailAsync Méthode

Définition

Surcharges

SendMailAsync(MailMessage)

Paramètres

Retours

Exceptions

Remarques

S’applique à

SendMailAsync(MailMessage, CancellationToken)

Paramètres

Retours

Exceptions

Remarques

S’applique à

SendMailAsync(String, String, String, String)

Paramètres

Retours

Exceptions

Remarques

S’applique à

SendMailAsync(String, String, String, String, CancellationToken)

Paramètres

Retours

Exceptions

Remarques

S’applique à

Ressources supplémentaires