SmtpFailedRecipientsException

.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

C#

[SerializableAttribute] 
public class SmtpFailedRecipientsException
 : SmtpFailedRecipientException, ISerializable

C++

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

J#

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

JScript

SerializableAttribute 
public class SmtpFailedRecipientsException
 extends SmtpFailedRecipientException implements ISerializable

解説

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

使用例

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

C#

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) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
SmtpFailedRecipientsException メンバ
System.Net.Mail 名前空間

SmtpFailedRecipientsException コンストラクタ ()

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

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

SmtpFailedRecipientsException クラスの空のインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New SmtpFailedRecipientsException

C#

public SmtpFailedRecipientsException ()

C++

public:
SmtpFailedRecipientsException ()

J#

public SmtpFailedRecipientsException ()

JScript

public function SmtpFailedRecipientsException
 ()

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
SmtpFailedRecipientsException クラス
SmtpFailedRecipientsException メンバ
System.Net.Mail 名前空間

SmtpFailedRecipientsException コンストラクタ (String)

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

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

String を指定して、SmtpFailedRecipientsException クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    message As String _
)

Visual Basic (使用法)

Dim message As String

Dim instance As New SmtpFailedRecipientsException(message)

C#

public SmtpFailedRecipientsException (
    string message
)

C++

public:
SmtpFailedRecipientsException (
    String^ message
)

J#

public SmtpFailedRecipientsException (
    String message
)

JScript

public function SmtpFailedRecipientsException
 (
    message : String
)

パラメータ

message

例外メッセージ。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
SmtpFailedRecipientsException クラス
SmtpFailedRecipientsException メンバ
System.Net.Mail 名前空間

SmtpFailedRecipientsException コンストラクタ (SerializationInfo, StreamingContext)

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

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

SerializationInfo クラスと StreamingContext クラスの指定したインスタンスから、SmtpFailedRecipientsException クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Protected Sub New ( _
    info As SerializationInfo, _
    context As StreamingContext _
)

Visual Basic (使用法)

Dim info As SerializationInfo
Dim context As StreamingContext

Dim instance As New SmtpFailedRecipientsException(info,
 context)

C#

protected SmtpFailedRecipientsException (
    SerializationInfo info,
    StreamingContext context
)

C++

protected:
SmtpFailedRecipientsException (
    SerializationInfo^ info, 
    StreamingContext context
)

J#

protected SmtpFailedRecipientsException (
    SerializationInfo info, 
    StreamingContext context
)

JScript

protected function SmtpFailedRecipientsException
 (
    info : SerializationInfo, 
    context : StreamingContext
)

パラメータ

info

新しい SmtpFailedRecipientsException インスタンスをシリアル化するために必要な情報を格納する SerializationInfo インスタンス。

context

新しい SmtpFailedRecipientsException インスタンスに関連付けられているシリアル化ストリームの転送元を格納している StreamingContext。

解説

このコンストラクタは、SmtpFailedRecipientsException クラスの ISerializable インターフェイスを実装します。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
SmtpFailedRecipientsException クラス
SmtpFailedRecipientsException メンバ
System.Net.Mail 名前空間
その他の技術情報
XML シリアル化および SOAP シリアル化

SmtpFailedRecipientsException コンストラクタ (String, Exception)

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

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

String と内部 Exception を指定して、SmtpFailedRecipientsException クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    message As String, _
    innerException As Exception _
)

Visual Basic (使用法)

Dim message As String
Dim innerException As Exception

Dim instance As New SmtpFailedRecipientsException(message,
 innerException)

C#

public SmtpFailedRecipientsException (
    string message,
    Exception innerException
)

C++

public:
SmtpFailedRecipientsException (
    String^ message, 
    Exception^ innerException
)

J#

public SmtpFailedRecipientsException (
    String message, 
    Exception innerException
)

JScript

public function SmtpFailedRecipientsException
 (
    message : String, 
    innerException : Exception
)

パラメータ

message

例外メッセージ。

innerException

内部例外。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
SmtpFailedRecipientsException クラス
SmtpFailedRecipientsException メンバ
System.Net.Mail 名前空間

SmtpFailedRecipientsException コンストラクタ (String, SmtpFailedRecipientException[])

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

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

String と SmtpFailedRecipientException 型の配列を指定して、SmtpFailedRecipientsException クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    message As String, _
    innerExceptions As SmtpFailedRecipientException() _
)

Visual Basic (使用法)

Dim message As String
Dim innerExceptions As SmtpFailedRecipientException()

Dim instance As New SmtpFailedRecipientsException(message,
 innerExceptions)

C#

public SmtpFailedRecipientsException (
    string message,
    SmtpFailedRecipientException[] innerExceptions
)

C++

public:
SmtpFailedRecipientsException (
    String^ message, 
    array<SmtpFailedRecipientException^>^ innerExceptions
)

J#

public SmtpFailedRecipientsException (
    String message, 
    SmtpFailedRecipientException[] innerExceptions
)

JScript

public function SmtpFailedRecipientsException
 (
    message : String, 
    innerExceptions : SmtpFailedRecipientException[]
)

パラメータ

message

例外メッセージ。

innerExceptions

配信エラーが発生した受信者の配列。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
SmtpFailedRecipientsException クラス
SmtpFailedRecipientsException メンバ
System.Net.Mail 名前空間

SmtpFailedRecipientsException コンストラクタ

SmtpFailedRecipientsException クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
SmtpFailedRecipientsException ()	SmtpFailedRecipientsException クラスの空のインスタンスを初期化します。
SmtpFailedRecipientsException (String)	String を指定して、SmtpFailedRecipientsException クラスの新しいインスタンスを初期化します。
SmtpFailedRecipientsException (SerializationInfo, StreamingContext)	SerializationInfo クラスと StreamingContext クラスの指定したインスタンスから、SmtpFailedRecipientsException クラスの新しいインスタンスを初期化します。
SmtpFailedRecipientsException (String, Exception)	String と内部 Exception を指定して、SmtpFailedRecipientsException クラスの新しいインスタンスを初期化します。
SmtpFailedRecipientsException (String, SmtpFailedRecipientException[])	String と SmtpFailedRecipientException 型の配列を指定して、SmtpFailedRecipientsException クラスの新しいインスタンスを初期化します。

参照

関連項目

SmtpFailedRecipientsException クラス
SmtpFailedRecipientsException メンバ
System.Net.Mail 名前空間

SmtpFailedRecipientsException プロパティ

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	Data	例外に関する追加のユーザー定義情報を提供するキー/値ペアのコレクションを取得します。 ( Exception から継承されます。)
	FailedRecipient	配信が困難な電子メール アドレスを示します。 ( SmtpFailedRecipientException から継承されます。)
	HelpLink	例外に関連付けられているヘルプ ファイルへのリンクを取得または設定します。 ( Exception から継承されます。)
	InnerException	現在の例外を発生させた Exception インスタンスを取得します。 ( Exception から継承されます。)
	InnerExceptions	SMTP 配信エラーが発生した電子メール受信者を示す 1 つ以上の SmtpFailedRecipientException を取得します。
	Message	現在の例外を説明するメッセージを取得します。 ( Exception から継承されます。)
	Source	エラーの原因となったアプリケーションまたはオブジェクトの名前を取得または設定します。 ( Exception から継承されます。)
	StackTrace	現在の例外がスローされたときにコール スタックにあったフレームの文字列形式を取得します。 ( Exception から継承されます。)
	StatusCode	電子メール メッセージが送信されたときに SMTP サーバーによって返されるステータス コードを取得します。 ( SmtpException から継承されます。)
	TargetSite	現在の例外をスローするメソッドを取得します。 ( Exception から継承されます。)

プロテクト プロパティ

	名前	説明
	HResult	特定の例外に割り当てられているコード化数値である HRESULT を取得または設定します。 ( Exception から継承されます。)

参照

関連項目

SmtpFailedRecipientsException クラス
System.Net.Mail 名前空間

SmtpFailedRecipientsException メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetBaseException	派生クラスでオーバーライドされた場合、それ以後に発生する 1 つ以上の例外の主要な原因である Exception を返します。 ( Exception から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetObjectData	オーバーライドされます。 SerializationInfo インスタンスに、SmtpFailedRecipientsException をシリアル化するために必要なデータを設定します。
	GetType	現在のインスタンスのランタイム型を取得します。 ( Exception から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の例外の文字列形式を作成して返します。 ( Exception から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

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

	名前	説明
	System.Runtime.Serialization.ISerializable.GetObjectData	指定した SerializationInfo インスタンスと StreamingContext インスタンスから、SmtpFailedRecipientsException クラスの新しいインスタンスを初期化します。

参照

関連項目

SmtpFailedRecipientsException クラス
System.Net.Mail 名前空間

SmtpFailedRecipientsException メンバ

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

SmtpFailedRecipientsException データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

( プロテクト コンストラクタ も参照)

	名前	説明
	SmtpFailedRecipientsException	オーバーロードされます。 SmtpFailedRecipientsException クラスの新しいインスタンスを初期化します。

プロテクト コンストラクタ

	名前	説明
	SmtpFailedRecipientsException	オーバーロードされます。 SmtpFailedRecipientsException クラスの新しいインスタンスを初期化します。

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	Data	例外に関する追加のユーザー定義情報を提供するキー/値ペアのコレクションを取得します。(Exception から継承されます。)
	FailedRecipient	配信が困難な電子メール アドレスを示します。(SmtpFailedRecipientException から継承されます。)
	HelpLink	例外に関連付けられているヘルプ ファイルへのリンクを取得または設定します。(Exception から継承されます。)
	InnerException	現在の例外を発生させた Exception インスタンスを取得します。(Exception から継承されます。)
	InnerExceptions	SMTP 配信エラーが発生した電子メール受信者を示す 1 つ以上の SmtpFailedRecipientException を取得します。
	Message	現在の例外を説明するメッセージを取得します。(Exception から継承されます。)
	Source	エラーの原因となったアプリケーションまたはオブジェクトの名前を取得または設定します。(Exception から継承されます。)
	StackTrace	現在の例外がスローされたときにコール スタックにあったフレームの文字列形式を取得します。(Exception から継承されます。)
	StatusCode	電子メール メッセージが送信されたときに SMTP サーバーによって返されるステータス コードを取得します。(SmtpException から継承されます。)
	TargetSite	現在の例外をスローするメソッドを取得します。(Exception から継承されます。)

プロテクト プロパティ

	名前	説明
	HResult	特定の例外に割り当てられているコード化数値である HRESULT を取得または設定します。(Exception から継承されます。)

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetBaseException	派生クラスでオーバーライドされた場合、それ以後に発生する 1 つ以上の例外の主要な原因である Exception を返します。 (Exception から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetObjectData	オーバーライドされます。 SerializationInfo インスタンスに、SmtpFailedRecipientsException をシリアル化するために必要なデータを設定します。
	GetType	現在のインスタンスのランタイム型を取得します。 (Exception から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の例外の文字列形式を作成して返します。 (Exception から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

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

	名前	説明
	System.Runtime.Serialization.ISerializable.GetObjectData	指定した SerializationInfo インスタンスと StreamingContext インスタンスから、SmtpFailedRecipientsException クラスの新しいインスタンスを初期化します。

参照

関連項目

SmtpFailedRecipientsException クラス
System.Net.Mail 名前空間