SmtpFailedRecipientsException クラスとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

SmtpFailedRecipientsException クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

このクラスは、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。

SmtpClient を使用して電子メールを送信し、その電子メールがすべての受信者に配信できない場合にスローされる例外。

名前空間: System.Net.Mail
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
Public Class SmtpFailedRecipientsException
    Inherits SmtpFailedRecipientException
    Implements ISerializable

Visual Basic (使用法)

Dim instance As SmtpFailedRecipientsException

[SerializableAttribute] 
public class SmtpFailedRecipientsException
 : SmtpFailedRecipientException, ISerializable

C++

[SerializableAttribute] 
public ref class SmtpFailedRecipientsException
 : public SmtpFailedRecipientException, ISerializable

/** @attribute SerializableAttribute() */ 
public class SmtpFailedRecipientsException
 extends SmtpFailedRecipientException implements ISerializable

JScript

SerializableAttribute 
public class SmtpFailedRecipientsException
 extends SmtpFailedRecipientException implements ISerializable

解説

InnerExceptions プロパティは、電子メールを送信しようとしたときに受け取る例外を格納します。この電子メールは、一部の受信者に対しては正常に配信された可能性があります。

使用例

メールボックスがビジーまたは使用不可能であったために配信されなかった電子メールメッセージを再送信するコード例を次に示します。

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
 e-mail 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 e-mail 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.FailedRecipient[i]);
            }
        }
    }
}

継承階層

System.Object
   System.Exception
     System.Net.Mail.SmtpException
       System.Net.Mail.SmtpFailedRecipientException
        System.Net.Mail.SmtpFailedRecipientsException

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。