SmtpFailedRecipientsException SmtpFailedRecipientsException SmtpFailedRecipientsException SmtpFailedRecipientsException Class

定義

SmtpClient を使用して電子メールを送信し、その電子メールがすべての受信者に配信できない場合にスローされる例外。The exception that is thrown when email is sent using an SmtpClient and cannot be delivered to all recipients.

この API は製品インフラストラクチャをサポートします。コードから直接使用するものではありません。

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
継承
属性
実装

次のコード例では、メールボックスがビジーであるか使用できないために配信されなかった電子メールメッセージを再送信します。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() );
          }
      }

注釈

プロパティInnerExceptionsは、電子メールを送信しようとしたときに受信した例外を格納します。The InnerExceptions property contains the exceptions received while attempting to send email. 電子メールがいくつかの受信者に正常に配信された可能性があります。The email might have been successfully delivered to some of the recipients.

コンストラクター

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

SmtpFailedRecipientsException クラスの空のインスタンスを初期化します。Initializes an empty instance of the SmtpFailedRecipientsException class.

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

SerializationInfo クラスと StreamingContext クラスの指定したインスタンスから、SmtpFailedRecipientsException クラスの新しいインスタンスを初期化します。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)

SmtpFailedRecipientsException を指定して、String クラスの新しいインスタンスを初期化します。Initializes a new instance of the SmtpFailedRecipientsException class with the specified String.

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

SmtpFailedRecipientsException と内部 String を指定して、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[])

SmtpFailedRecipientsExceptionString 型の配列を指定して、SmtpFailedRecipientException クラスの新しいインスタンスを初期化します。Initializes a new instance of the SmtpFailedRecipientsException class with the specified String and array of type SmtpFailedRecipientException.

プロパティ

Data Data Data Data

例外に関する追加のユーザー定義情報を提供する、キー/値ペアのコレクションを取得します。Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Inherited from Exception)
FailedRecipient FailedRecipient FailedRecipient FailedRecipient

配信が困難な電子メール アドレスを示します。Indicates the email address with delivery difficulties.

(Inherited from SmtpFailedRecipientException)
HelpLink HelpLink HelpLink HelpLink

この例外に関連付けられているヘルプ ファイルへのリンクを取得または設定します。Gets or sets a link to the help file associated with this exception.

(Inherited from Exception)
HResult HResult HResult HResult

特定の例外に割り当てられているコード化数値である HRESULT を取得または設定します。Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Inherited from Exception)
InnerException InnerException InnerException InnerException

現在の例外の原因となる Exception インスタンスを取得します。Gets the Exception instance that caused the current exception.

(Inherited from Exception)
InnerExceptions InnerExceptions InnerExceptions InnerExceptions

SMTP 配信エラーが発生した電子メール受信者を示す 1 つ以上の SmtpFailedRecipientException を取得します。Gets one or more SmtpFailedRecipientExceptions that indicate the email recipients with SMTP delivery errors.

Message Message Message Message

現在の例外を説明するメッセージを取得します。Gets a message that describes the current exception.

(Inherited from Exception)
Source Source Source Source

エラーの原因となるアプリケーションまたはオブジェクトの名前を取得または設定します。Gets or sets the name of the application or the object that causes the error.

(Inherited from Exception)
StackTrace StackTrace StackTrace StackTrace

呼び出し履歴で直前のフレームの文字列形式を取得します。Gets a string representation of the immediate frames on the call stack.

(Inherited from Exception)
StatusCode StatusCode StatusCode StatusCode

電子メール メッセージが送信されたときに SMTP サーバーによって返されるステータス コードを取得します。Gets the status code returned by an SMTP server when an email message is transmitted.

(Inherited from SmtpException)
TargetSite TargetSite TargetSite TargetSite

現在の例外がスローされたメソッドを取得します。Gets the method that throws the current exception.

(Inherited from Exception)

メソッド

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

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

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

派生クラスでオーバーライドされた場合、それ以後に発生する 1 つ以上の例外の主要な原因である Exception を返します。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()

既定のハッシュ関数として機能します。Serves as the default hash function.

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

SerializationInfo インスタンスに、SmtpFailedRecipientsException をシリアル化するために必要なデータを設定します。Populates a SerializationInfo instance with the data that is needed to serialize the SmtpFailedRecipientsException.

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

現在のインスタンスのランタイム型を取得します。Gets the runtime type of the current instance.

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

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

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

現在の例外の文字列形式を作成して返します。Creates and returns a string representation of the current exception.

(Inherited from Exception)

明示的なインターフェイスの実装

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

指定した SmtpFailedRecipientsException インスタンスと SerializationInfo インスタンスから、StreamingContext クラスの新しいインスタンスを初期化します。Initializes a new instance of the SmtpFailedRecipientsException class from the specified SerializationInfo and StreamingContext instances.

イベント

SerializeObjectState SerializeObjectState SerializeObjectState SerializeObjectState

例外がシリアル化され、例外に関するシリアル化されたデータを含む例外状態オブジェクトが作成されたときに発生します。Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Inherited from Exception)

適用対象