Compartilhar via


SmtpClient.SendMailAsync Método

Definição

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

Sobrecargas

SendMailAsync(MailMessage)

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

SendMailAsync(MailMessage, CancellationToken)

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, os destinatários, o assunto e o corpo da mensagem são especificados usando objetos String.

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

Envia a mensagem especificada a um servidor SMTP para entrega como uma operação assíncrona, usando o remetente, os destinatários, o assunto e as cadeias de caracteres de corpo especificados.

SendMailAsync(MailMessage)

Origem:
SmtpClient.cs
Origem:
SmtpClient.cs
Origem:
SmtpClient.cs

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

Um MailMessage que contém a mensagem a ser enviada.

Retornos

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

Exceções

message é null.

Isso SmtpClient tem outra operação de envio já em andamento.

- ou -

Não há nenhum destinatário especificado nas propriedades To, CC e Bcc.

- ou -

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

- ou -

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

- ou -

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

O objeto foi descartado.

Falha na conexão com o servidor SMTP.

- ou -

Falha na autenticação.

- ou -

Tempo limite da operação esgotado.

- ou -

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

- ou -

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

- ou -

O message não pôde ser entregue a um ou mais dos destinatários em To, CC ou Bcc.

O message não pôde ser entregue a um dos destinatários em To, CC ou Bcc.

O message não pôde ser entregue a dois ou mais dos destinatários em To, CC ou Bcc.

Comentários

Essa operação não será bloqueada. O objeto retornado Task será concluído depois que a mensagem for enviada.

Aplica-se a

SendMailAsync(MailMessage, CancellationToken)

Origem:
SmtpClient.cs
Origem:
SmtpClient.cs
Origem:
SmtpClient.cs

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, 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

Parâmetros

message
MailMessage

A mensagem a enviar.

cancellationToken
CancellationToken

O token de cancelamento para cancelar a operação.

Retornos

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

Exceções

message é null.

Isso SmtpClient tem outra operação de envio já em andamento.

- ou -

From é null.

- ou -

Não há nenhum destinatário especificado nas propriedades To, CC e Bcc.

- ou -

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

- ou -

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

- ou -

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

O objeto foi descartado.

Falha na conexão com o servidor SMTP.

- ou -

Falha na autenticação.

- ou -

Tempo limite da operação esgotado.

- ou -

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

- ou -

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

- ou -

O message não pôde ser entregue a um ou mais dos destinatários em To, CC ou Bcc.

O message não pôde ser entregue a um dos destinatários em To, CC ou Bcc.

O message não pôde ser entregue a dois ou mais dos destinatários em To, CC ou Bcc.

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

Comentários

Essa operação não será bloqueada. O objeto retornado Task será concluído depois que a mensagem for enviada.

Aplica-se a

SendMailAsync(String, String, String, String)

Origem:
SmtpClient.cs
Origem:
SmtpClient.cs
Origem:
SmtpClient.cs

Envia a mensagem especificada para um servidor SMTP para entrega como uma operação assíncrona. O remetente, os destinatários, o assunto e o corpo da mensagem são especificados usando objetos 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

Parâmetros

from
String

Um String que contém as informações de endereço do remetente da mensagem.

recipients
String

Um String que contém os endereços aos quais a mensagem é enviada.

subject
String

Um String que contém a linha do assunto da mensagem.

body
String

Um String que contém o corpo da mensagem.

Retornos

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

Exceções

from é null.

- ou -

recipients é null.

from é Empty.

- ou -

recipients é Empty.

Isso SmtpClient tem outra operação de envio já em andamento.

- ou -

From é null.

- ou -

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

- ou -

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

- ou -

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

O objeto foi descartado.

Falha na conexão com o servidor SMTP.

- ou -

Falha na autenticação.

- ou -

Tempo limite da operação esgotado.

- ou -

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

- ou -

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

- ou -

O message não pôde ser entregue a um ou mais dos destinatários em To, CC ou Bcc.

O message não pôde ser entregue a um dos destinatários em To, CC ou Bcc.

O message não pôde ser entregue a dois ou mais dos destinatários em To, CC ou Bcc.

Comentários

Esta operação não será bloqueada. O objeto retornado Task será concluído depois que a mensagem for enviada.

Aplica-se a

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

Origem:
SmtpClient.cs
Origem:
SmtpClient.cs
Origem:
SmtpClient.cs

Envia a mensagem especificada a um servidor SMTP para entrega como uma operação assíncrona, usando o remetente, os destinatários, o assunto e as cadeias de caracteres de corpo especificados.

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

Parâmetros

from
String

As informações de endereço do remetente da mensagem.

recipients
String

Os endereços para os quais a mensagem é enviada.

subject
String

A linha de assunto da mensagem.

body
String

O corpo da mensagem.

cancellationToken
CancellationToken

O token de cancelamento para cancelar a operação.

Retornos

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

Exceções

from é null.

- ou -

recipients é null.

from é Empty.

- ou -

recipients é Empty.

Isso SmtpClient tem outra operação de envio já em andamento.

- ou -

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

- ou -

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

- ou -

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

O objeto foi descartado.

Falha na conexão com o servidor SMTP.

- ou -

Falha na autenticação.

- ou -

Tempo limite da operação esgotado.

- ou -

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

- ou -

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

- ou -

O message não pôde ser entregue a um ou mais dos destinatários em To, CC ou Bcc.

O message não pôde ser entregue a um dos destinatários em To, CC ou Bcc.

O message não pôde ser entregue a dois ou mais dos destinatários em To, CC ou Bcc.

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

Comentários

Esta operação não será bloqueada. O objeto retornado Task será concluído depois que a mensagem for enviada.

Aplica-se a