SmtpFailedRecipientsException Classe
Definição
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.
A exceção que é lançada quando o email é enviado através de um SmtpClient e não pode ser entregue a todos os destinatários.
Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código.
public ref class SmtpFailedRecipientsException : System::Net::Mail::SmtpFailedRecipientExceptionpublic class SmtpFailedRecipientsException : System.Net.Mail.SmtpFailedRecipientException[System.Serializable]
public class SmtpFailedRecipientsException : System.Net.Mail.SmtpFailedRecipientExceptiontype SmtpFailedRecipientsException = class
inherit SmtpFailedRecipientExceptiontype SmtpFailedRecipientsException = class
inherit SmtpFailedRecipientException
interface ISerializable[<System.Serializable>]
type SmtpFailedRecipientsException = class
inherit SmtpFailedRecipientException
interface ISerializablePublic Class SmtpFailedRecipientsException
Inherits SmtpFailedRecipientException- Herança
- Atributos
- Implementações
Exemplos
O exemplo de código seguinte reenvia uma mensagem de email que não foi entregue porque uma caixa de correio estava ocupada ou indisponível.
public static void RetryIfBusy(string server)
{
MailAddress from = new MailAddress("ben@contoso.com");
MailAddress to = new MailAddress("jane@contoso.com");
MailMessage message = new MailMessage(from, to);
// message.Subject = "Using the SmtpClient class.";
message.Subject = "Using the SmtpClient class.";
message.Body = @"Using this feature, you can send an email message from an application very easily.";
// Add a carbon copy recipient.
MailAddress copy = new MailAddress("Notifications@contoso.com");
message.CC.Add(copy);
SmtpClient client = new SmtpClient(server);
// Include credentials if the server requires them.
client.Credentials = (ICredentialsByHost)CredentialCache.DefaultNetworkCredentials;
Console.WriteLine("Sending an email message to {0} using the SMTP host {1}.",
to.Address, client.Host);
try
{
client.Send(message);
}
catch (SmtpFailedRecipientsException ex)
{
for (int i = 0; i < ex.InnerExceptions.Length; i++)
{
SmtpStatusCode status = ex.InnerExceptions[i].StatusCode;
if (status == SmtpStatusCode.MailboxBusy ||
status == SmtpStatusCode.MailboxUnavailable)
{
Console.WriteLine("Delivery failed - retrying in 5 seconds.");
System.Threading.Thread.Sleep(5000);
client.Send(message);
}
else
{
Console.WriteLine("Failed to deliver message to {0}",
ex.InnerExceptions[i].FailedRecipient);
}
}
}
catch (Exception ex)
{
Console.WriteLine("Exception caught in RetryIfBusy(): {0}",
ex.ToString());
}
}
Observações
A InnerExceptions propriedade contém as exceções recebidas ao tentar enviar um email. O email pode ter sido entregue com sucesso a alguns dos destinatários.
Construtores
| Name | Description |
|---|---|
| SmtpFailedRecipientsException() |
Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código. Inicializa uma instância vazia da SmtpFailedRecipientsException classe. |
| SmtpFailedRecipientsException(SerializationInfo, StreamingContext) |
Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código.
Obsoleto.
Inicializa uma nova instância da SmtpFailedRecipientsException classe a partir das instâncias especificadas das SerializationInfo classes e StreamingContext . |
| SmtpFailedRecipientsException(String, Exception) |
Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código. Inicializa uma nova instância da SmtpFailedRecipientsException classe com o especificado String e interno Exception. |
| SmtpFailedRecipientsException(String, SmtpFailedRecipientException[]) |
Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código. Inicializa uma nova instância da SmtpFailedRecipientsException classe com o array especificado String e do tipo SmtpFailedRecipientException. |
| SmtpFailedRecipientsException(String) |
Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código. Inicializa uma nova instância da SmtpFailedRecipientsException classe com o especificado String. |
Propriedades
| Name | Description |
|---|---|
| Data |
Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código. Obtém uma coleção de pares chave/valor que fornecem informação adicional definida pelo utilizador sobre a exceção. (Herdado de Exception) |
| FailedRecipient |
Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código. Indica o endereço de email com dificuldades de entrega. (Herdado de SmtpFailedRecipientException) |
| HelpLink |
Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código. Obtém ou define um link para o ficheiro de ajuda associado a esta exceção. (Herdado de Exception) |
| HResult |
Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código. Recebe ou define HRESULT, um valor numérico codificado atribuído a uma exceção específica. (Herdado de Exception) |
| InnerException |
Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código. Obtém a Exception instância que causou a exceção atual. (Herdado de Exception) |
| InnerExceptions |
Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código. Recebe um ou mais SmtpFailedRecipientExceptionS que indicam os destinatários do email com erros de entrega SMTP. |
| Message |
Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código. Recebe uma mensagem que descreve a exceção atual. (Herdado de Exception) |
| Source |
Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código. Obtém ou define o nome do aplicativo ou o objeto que causa o erro. (Herdado de Exception) |
| StackTrace |
Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código. Obtém uma representação string dos frames imediatos na stack de chamadas. (Herdado de Exception) |
| StatusCode |
Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código. Recebe o código de estado devolvido por um servidor SMTP quando uma mensagem de email é transmitida. (Herdado de SmtpException) |
| TargetSite |
Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código. Obtém o método que lança a exceção atual. (Herdado de Exception) |
Métodos
| Name | Description |
|---|---|
| Equals(Object) |
Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código. Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetBaseException() |
Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código. Quando sobrescrito numa classe derivada, devolve o Exception que é a causa raiz de uma ou mais exceções subsequentes. (Herdado de Exception) |
| GetHashCode() |
Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código. Serve como função de hash predefinida. (Herdado de Object) |
| GetObjectData(SerializationInfo, StreamingContext) |
Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código.
Obsoleto.
Preenche uma SerializationInfo instância com os dados necessários para serializar o SmtpFailedRecipientsException. |
| GetType() |
Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código. Obtém o tipo de execução da instância atual. (Herdado de Exception) |
| MemberwiseClone() |
Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código. Cria uma cópia superficial do atual Object. (Herdado de Object) |
| ToString() |
Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código. Cria e devolve uma representação string da exceção atual. (Herdado de Exception) |
evento
| Name | Description |
|---|---|
| SerializeObjectState |
Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código.
Obsoleto.
Ocorre quando uma exceção é serializada para criar um objeto de estado de exceção que contém dados serializados sobre a exceção. (Herdado de Exception) |
Implementações de Interface Explícita
| Name | Description |
|---|---|
| ISerializable.GetObjectData(SerializationInfo, StreamingContext) |
Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código. Inicializa uma nova instância da SmtpFailedRecipientsException classe a partir das instâncias e SerializationInfo especificadasStreamingContext. |
