SmtpClient.SendMailAsync Método

Definição

Espaço de Nomes:: System.Net.Mail

Assemblagem:: System.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Envia a mensagem especificada para um servidor SMTP para entrega como uma operação assíncrona.

Sobrecargas

Name	Description
SendMailAsync(MailMessage)	Envia a mensagem especificada para um servidor SMTP para entrega como uma operação assíncrona.
SendMailAsync(String, String, String, String)	Envia a mensagem especificada para um servidor SMTP para entrega como uma operação assíncrona. O remetente, destinatários, assunto e corpo da mensagem são especificados usando String objetos.

SendMailAsync(MailMessage)

Envia a mensagem especificada para um servidor SMTP para entrega como uma operação assíncrona.

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

Parâmetros

message: MailMessage

A MailMessage que contém a mensagem a enviar.

Devoluções

Task

O objeto tarefa que representa a operação assíncrona.

Exceções

ArgumentNullException

message é null.

InvalidOperationException

Isto SmtpClient já tem outra operação de envio em curso.

-ou-

Não existem destinatários especificados em To, CC, e Bcc propriedades.

-ou-

DeliveryMethod a propriedade é definida como Network e Host é null.

-ou-

DeliveryMethod a propriedade é definida como Network e Host é igual à cadeia vazia ("").

-ou-

DeliveryMethod a propriedade é definida como Network e Port é zero, um número negativo, ou maior que 65.535.

ObjectDisposedException

Este objeto foi descartado.

SmtpException

A ligação ao servidor SMTP falhou.

-ou-

Falha na autenticação.

-ou-

A operação expirou.

-ou-

EnableSsl é definido como true mas a DeliveryMethod propriedade está definida como SpecifiedPickupDirectory ou PickupDirectoryFromIis.

-ou-

EnableSsl está definido para true, , mas o servidor de email SMTP não anunciou o STARTTLS na resposta ao comando EHLO.

-ou-

Não message podiam ser entregues a um ou mais dos destinatários em To, CC, ou Bcc.

SmtpFailedRecipientException

Não message podiam ser entregues a um dos destinatários em To, CC, ou Bcc.

SmtpFailedRecipientsException

Não message podiam ser entregues a dois ou mais dos destinatários em To, CC, ou Bcc.

Observações

Esta operação não vai bloquear. O objeto devolvido Task será concluído assim que a mensagem for enviada.

Aplica-se a

SendMailAsync(String, String, String, String)

Envia a mensagem especificada para um servidor SMTP para entrega como uma operação assíncrona. O remetente, destinatários, assunto e corpo da mensagem são especificados usando String objetos.

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);

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

Parâmetros

from: String

A String que contém a informação de endereço do remetente da mensagem.

recipients: String

A String que contém os endereços para onde a mensagem é enviada.

subject: String

A String que contém o assunto da mensagem.

body: String

A String que contém o corpo da mensagem.

Devoluções

Task

O objeto tarefa que representa a operação assíncrona.

Exceções

ArgumentNullException

from é null.

-ou-

recipients é null.

ArgumentException

from é Empty.

-ou-

recipients é Empty.

InvalidOperationException

Isto SmtpClient já tem outra operação de envio em curso.

-ou-

From é null.

-ou-

DeliveryMethod a propriedade é definida como Network e Host é null.

-ou-

DeliveryMethod a propriedade é definida como Network e Host é igual à cadeia vazia ("").

-ou-

DeliveryMethod a propriedade é definida como Network e Port é zero, um número negativo, ou maior que 65.535.

ObjectDisposedException

Este objeto foi descartado.

SmtpException

A ligação ao servidor SMTP falhou.

-ou-

Falha na autenticação.

-ou-

A operação expirou.

-ou-

EnableSsl é definido como true mas a DeliveryMethod propriedade está definida como SpecifiedPickupDirectory ou PickupDirectoryFromIis.

-ou-

EnableSsl está definido para true, , mas o servidor de email SMTP não anunciou o STARTTLS na resposta ao comando EHLO.

-ou-

A mensagem não podia ser entregue a um ou mais dos destinatários em To, CC, ou Bcc.

SmtpFailedRecipientException

A mensagem não podia ser entregue a um dos destinatários em To, CC, ou Bcc.

SmtpFailedRecipientsException

A mensagem não podia ser entregue a dois ou mais dos destinatários em To, CC, ou Bcc.

Observações

Esta operação não vai bloquear. O objeto devolvido Task será concluído assim que a mensagem for enviada.

Aplica-se a

Comentários

Esta página foi útil?