SmtpFailedRecipientsException SmtpFailedRecipientsException SmtpFailedRecipientsException SmtpFailedRecipientsException Class

Definizione

Eccezione generata se il messaggio di posta elettronica viene inviato usando un SmtpClient e non viene recapitato a tutti i destinatari.The exception that is thrown when email is sent using an SmtpClient and cannot be delivered to all recipients.

Questa API supporta l'infrastruttura del prodotto e non è previsto che venga usata direttamente dal codice.

public ref class SmtpFailedRecipientsException : System::Net::Mail::SmtpFailedRecipientException
[System.Serializable]
public class SmtpFailedRecipientsException : System.Net.Mail.SmtpFailedRecipientException
type SmtpFailedRecipientsException = class
    inherit SmtpFailedRecipientException
    interface ISerializable
Public Class SmtpFailedRecipientsException
Inherits SmtpFailedRecipientException
Ereditarietà
Attributi
Implementazioni

Esempi

Esempio di codice seguente invia nuovamente un messaggio di posta elettronica non è stato recapitato perché una cassetta postale è occupato o non disponibile.The following code example resends an email message that was not delivered because a mailbox was busy or unavailable.

static void RetryIfBusy( String^ server )
{
   MailAddress^ from = gcnew MailAddress( L"ben@contoso.com" );
   MailAddress^ to = gcnew MailAddress( L"jane@contoso.com" );
   MailMessage^ message = gcnew MailMessage( from,to );
   
   // message.Subject = "Using the SmtpClient class.";
   message->Subject = L"Using the SmtpClient class.";
   message->Body = L"Using this feature, you can send an email message from an application very easily.";
   
   // Add a carbon copy recipient.
   MailAddress^ copy = gcnew MailAddress( L"Notifications@contoso.com" );
   message->CC->Add( copy );
   SmtpClient^ client = gcnew SmtpClient( server );
   
   // Include credentials if the server requires them.
   client->Credentials = dynamic_cast<ICredentialsByHost^>(CredentialCache::DefaultNetworkCredentials);
   Console::WriteLine( L"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( L"Delivery failed - retrying in 5 seconds." );
            System::Threading::Thread::Sleep( 5000 );
            client->Send( message );
         }
         else
         {
            Console::WriteLine( L"Failed to deliver message to {0}", ex->InnerExceptions[ i ] );
         }

      }
   }
   catch ( Exception^ ex )
   {
       Console::WriteLine(L"Exception caught in RetryIfBusy(): {0}", 
                     ex->ToString() );
   }
   finally
   {
      client->~SmtpClient();
   }
}


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

Commenti

Il InnerExceptions proprietà contiene le eccezioni ricevute durante il tentativo di invio di posta elettronica.The InnerExceptions property contains the exceptions received while attempting to send email. Messaggio di posta elettronica potrebbe essere sono stato recapitato ad alcuni dei destinatari.The email might have been successfully delivered to some of the recipients.

Costruttori

SmtpFailedRecipientsException() SmtpFailedRecipientsException() SmtpFailedRecipientsException() SmtpFailedRecipientsException()

Inizializza un'istanza vuota della classe SmtpFailedRecipientsException.Initializes an empty instance of the SmtpFailedRecipientsException class.

SmtpFailedRecipientsException(SerializationInfo, StreamingContext) SmtpFailedRecipientsException(SerializationInfo, StreamingContext) SmtpFailedRecipientsException(SerializationInfo, StreamingContext) SmtpFailedRecipientsException(SerializationInfo, StreamingContext)

Inizializza una nuova istanza della classe SmtpFailedRecipientsException dalle istanze specificate delle classi SerializationInfo e StreamingContext.Initializes a new instance of the SmtpFailedRecipientsException class from the specified instances of the SerializationInfo and StreamingContext classes.

SmtpFailedRecipientsException(String) SmtpFailedRecipientsException(String) SmtpFailedRecipientsException(String) SmtpFailedRecipientsException(String)

Inizializza una nuova istanza della classe SmtpFailedRecipientsException con l'oggetto String specificato.Initializes a new instance of the SmtpFailedRecipientsException class with the specified String.

SmtpFailedRecipientsException(String, Exception) SmtpFailedRecipientsException(String, Exception) SmtpFailedRecipientsException(String, Exception) SmtpFailedRecipientsException(String, Exception)

Inizializza una nuova istanza di SmtpFailedRecipientsException classe con l'oggetto specificato String interni ed Exception.Initializes a new instance of the SmtpFailedRecipientsException class with the specified String and inner Exception.

SmtpFailedRecipientsException(String, SmtpFailedRecipientException[]) SmtpFailedRecipientsException(String, SmtpFailedRecipientException[]) SmtpFailedRecipientsException(String, SmtpFailedRecipientException[]) SmtpFailedRecipientsException(String, SmtpFailedRecipientException[])

Inizializza una nuova istanza di SmtpFailedRecipientsException classe con l'oggetto specificato String e matrice di tipo SmtpFailedRecipientException.Initializes a new instance of the SmtpFailedRecipientsException class with the specified String and array of type SmtpFailedRecipientException.

Proprietà

Data Data Data Data

Ottiene una raccolta di coppie chiave-valore che fornisce informazioni aggiuntive definite dall'utente relative all'eccezione.Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Inherited from Exception)
FailedRecipient FailedRecipient FailedRecipient FailedRecipient

Indica l'indirizzo di posta elettronica con problemi di consegna.Indicates the email address with delivery difficulties.

(Inherited from SmtpFailedRecipientException)
HelpLink HelpLink HelpLink HelpLink

Ottiene o imposta un collegamento al file della Guida associato all'eccezione.Gets or sets a link to the help file associated with this exception.

(Inherited from Exception)
HResult HResult HResult HResult

Ottiene o imposta HRESULT, un valore numerico codificato che viene assegnato a un'eccezione specifica.Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Inherited from Exception)
InnerException InnerException InnerException InnerException

Ottiene l'istanza di Exception che ha causato l'eccezione corrente.Gets the Exception instance that caused the current exception.

(Inherited from Exception)
InnerExceptions InnerExceptions InnerExceptions InnerExceptions

Ottiene una o più SmtpFailedRecipientException che indicano i destinatari dei messaggi di posta elettronica con errori di consegna SMTP.Gets one or more SmtpFailedRecipientExceptions that indicate the email recipients with SMTP delivery errors.

Message Message Message Message

Ottiene un messaggio che descrive l'eccezione corrente.Gets a message that describes the current exception.

(Inherited from Exception)
Source Source Source Source

Ottiene o imposta il nome dell'oggetto o dell'applicazione che ha generato l'errore.Gets or sets the name of the application or the object that causes the error.

(Inherited from Exception)
StackTrace StackTrace StackTrace StackTrace

Ottiene una rappresentazione di stringa dei frame immediati nello stack di chiamate.Gets a string representation of the immediate frames on the call stack.

(Inherited from Exception)
StatusCode StatusCode StatusCode StatusCode

Ottiene il codice di stato restituito da un server SMTP quando viene trasmesso un messaggio di posta elettronica.Gets the status code returned by an SMTP server when an email message is transmitted.

(Inherited from SmtpException)
TargetSite TargetSite TargetSite TargetSite

Ottiene il metodo che genera l'eccezione corrente.Gets the method that throws the current exception.

(Inherited from Exception)

Metodi

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetBaseException() GetBaseException() GetBaseException() GetBaseException()

Se utilizzato come metodo di override in una classe derivata, restituisce l'Exception che è la causa radice di una o più eccezioni successive.When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

(Inherited from Exception)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext)

Popola un SerializationInfo istanza con i dati necessari per serializzare il SmtpFailedRecipientsException.Populates a SerializationInfo instance with the data that is needed to serialize the SmtpFailedRecipientsException.

GetType() GetType() GetType() GetType()

Ottiene il tipo di runtime dell'istanza corrente.Gets the runtime type of the current instance.

(Inherited from Exception)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Crea e restituisce una rappresentazione di stringa dell'eccezione corrente.Creates and returns a string representation of the current exception.

(Inherited from Exception)

Implementazioni dell'interfaccia esplicita

ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Inizializza una nuova istanza della classe SmtpFailedRecipientsException dalle istanze di SerializationInfo e StreamingContext specificate.Initializes a new instance of the SmtpFailedRecipientsException class from the specified SerializationInfo and StreamingContext instances.

Eventi

SerializeObjectState SerializeObjectState SerializeObjectState SerializeObjectState

Si verifica quando un'eccezione viene serializzata per creare un oggetto di stato eccezione contenente i dati serializzati relativi all'eccezione.Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Inherited from Exception)

Si applica a