SmtpFailedRecipientsException 類別

定義

命名空間:

System.Net.Mail

組件:

System.Net.Mail.dll

來源:

SmtpFailedRecipientsException.cs

例外狀況，在使用 SmtpClient 傳送電子郵件，且無法將電子郵件傳遞至所有收件者時擲回。

此 API 支援此產品基礎結構，但無法直接用於程式碼之中。

public ref class SmtpFailedRecipientsException : System::Net::Mail::SmtpFailedRecipientException

public class SmtpFailedRecipientsException : System.Net.Mail.SmtpFailedRecipientException

type SmtpFailedRecipientsException = class
    inherit SmtpFailedRecipientException

Public Class SmtpFailedRecipientsException
Inherits SmtpFailedRecipientException

繼承

Object

Exception

SmtpException

SmtpFailedRecipientException

SmtpFailedRecipientsException

範例

下列程式代碼範例會重新傳送因為信箱忙碌或無法使用而未傳遞的電子郵件訊息。

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

備註

屬性 InnerExceptions 包含嘗試傳送電子郵件時收到的例外狀況。 電子郵件可能已成功傳遞至某些收件者。

建構函式

SmtpFailedRecipientsException()	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 初始化 SmtpFailedRecipientsException 類別的空執行個體。
SmtpFailedRecipientsException(SerializationInfo, StreamingContext)	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 已淘汰. 初始化 SmtpFailedRecipientsException 類別的新執行個體，這個執行個體是來自 SerializationInfo 和 StreamingContext 類別的指定執行個體。
SmtpFailedRecipientsException(String)	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 使用指定的 SmtpFailedRecipientsException 初始化 String 類別的新執行個體。
SmtpFailedRecipientsException(String, Exception)	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 使用指定的 SmtpFailedRecipientsException 和內部 String，初始化 Exception 類別的新執行個體。
SmtpFailedRecipientsException(String, SmtpFailedRecipientException[])	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 使用指定的 SmtpFailedRecipientsException 和 String 類型的陣列，初始化 SmtpFailedRecipientException 類別的新執行個體。

屬性

Data	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得鍵值組的集合，這些鍵值組會提供關於例外狀況的其他使用者定義資訊。 (繼承來源 Exception)
FailedRecipient	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 指示傳遞發生問題的電子郵件地址。 (繼承來源 SmtpFailedRecipientException)
HelpLink	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得或設定與這個例外狀況相關聯的說明檔連結。 (繼承來源 Exception)
HResult	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得或設定 HRESULT，它是指派給特定例外狀況的編碼數值。 (繼承來源 Exception)
InnerException	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得造成目前例外狀況的 Exception 執行個體。 (繼承來源 Exception)
InnerExceptions	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得一或多個 SmtpFailedRecipientException，指示發生 SMTP 傳遞錯誤的電子郵件收件者。
Message	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得描述目前例外狀況的訊息。 (繼承來源 Exception)
Source	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得或設定造成錯誤的應用程式或物件的名稱。 (繼承來源 Exception)
StackTrace	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得呼叫堆疊上即時運算框架的字串表示。 (繼承來源 Exception)
StatusCode	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得在傳送電子郵件訊息時，SMTP 伺服器所傳回的狀態碼。 (繼承來源 SmtpException)
TargetSite	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得擲回目前例外狀況的方法。 (繼承來源 Exception)

方法

Equals(Object)	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetBaseException()	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 在衍生類別中覆寫時，傳回一或多個後續的例外狀況的根本原因 Exception。 (繼承來源 Exception)
GetHashCode()	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 做為預設雜湊函式。 (繼承來源 Object)
GetObjectData(SerializationInfo, StreamingContext)	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 已淘汰. 以序列化 SerializationInfo 所需的資料填入 SmtpFailedRecipientsException 執行個體。
GetType()	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得目前執行個體的執行階段類型。 (繼承來源 Exception)
MemberwiseClone()	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 建立並傳回目前例外狀況的字串表示。 (繼承來源 Exception)

事件

SerializeObjectState

此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 已淘汰. 當例外狀況序列化，以建立包含例外狀況相關序列化資料的例外狀況狀態物件時，就會發生此事件。 (繼承來源 Exception)