SmtpClient.SendMailAsync Método

Referência

Definição

Namespace:: System.Net.Mail

Assembly:: System.Net.Mail.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

Task

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

Exceções

ArgumentNullException

message é null.

InvalidOperationException

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.

ObjectDisposedException

O objeto foi descartado.

SmtpException

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.

SmtpFailedRecipientException

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

SmtpFailedRecipientsException

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

Task

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

Exceções

ArgumentNullException

message é null.

InvalidOperationException

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.

ObjectDisposedException

O objeto foi descartado.

SmtpException

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.

SmtpFailedRecipientException

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

SmtpFailedRecipientsException

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

OperationCanceledException

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

Task

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

Exceções

ArgumentNullException

from é null.

- ou -

recipients é null.

ArgumentException

from é Empty.

- ou -

recipients é Empty.

InvalidOperationException

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.

ObjectDisposedException

O objeto foi descartado.

SmtpException

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.

SmtpFailedRecipientException

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

SmtpFailedRecipientsException

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

Task

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

Exceções

ArgumentNullException

from é null.

- ou -

recipients é null.

ArgumentException

from é Empty.

- ou -

recipients é Empty.

InvalidOperationException

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.

ObjectDisposedException

O objeto foi descartado.

SmtpException

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.

SmtpFailedRecipientException

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

SmtpFailedRecipientsException

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

OperationCanceledException

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

Partilhar via

SmtpClient.SendMailAsync Método

Definição

Sobrecargas

SendMailAsync(MailMessage)

Parâmetros

Retornos

Exceções

Comentários

Aplica-se a

SendMailAsync(MailMessage, CancellationToken)

Parâmetros

Retornos

Exceções

Comentários

Aplica-se a

SendMailAsync(String, String, String, String)

Parâmetros

Retornos

Exceções

Comentários

Aplica-se a

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

Parâmetros

Retornos

Exceções

Comentários

Aplica-se a

Recursos adicionais