SmtpExceptionとは何？わかりやすく解説 Weblio辞書

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

SmtpClient が Send 操作または SendAsync 操作を完了できない場合にスローされる例外を表します。

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

<SerializableAttribute> _
Public Class SmtpException
    Inherits Exception
    Implements ISerializable

Visual Basic (使用法)

Dim instance As SmtpException

C#

[SerializableAttribute] 
public class SmtpException : Exception, ISerializable

C++

[SerializableAttribute] 
public ref class SmtpException : public
 Exception, ISerializable

J#

/** @attribute SerializableAttribute() */ 
public class SmtpException extends Exception
 implements ISerializable

JScript

SerializableAttribute 
public class SmtpException extends
 Exception implements ISerializable

解説

StatusCode プロパティは、SMTP サーバーによって返されるステータスコードを格納します。

使用例

SmtpException 例外がスローされたときにエラーメッセージを表示するコード例を次に示します。

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

スレッドセーフ

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

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

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

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

SmtpException クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New SmtpException

C#

public SmtpException ()

C++

public:
SmtpException ()

J#

public SmtpException ()

JScript

public function SmtpException ()

解説

このコンストラクタによって返される例外は、StatusCode プロパティが GeneralFailure に設定されています。

使用例

このコンストラクタを呼び出すコード例を次に示します。

C#

public static SmtpException GenerateDefaultSmtpException()
{
    return new SmtpException();
}

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

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

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

指定したエラーメッセージと内部例外を使用して、SmtpException クラスの新しいインスタンスを初期化します。

名前空間: 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 SmtpException(message,
 innerException)

C#

public SmtpException (
    string message,
    Exception innerException
)

C++

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

J#

public SmtpException (
    String message, 
    Exception innerException
)

JScript

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

パラメータ

message: 発生したエラーを説明する String。

innerException: 現在の例外の原因である例外。

解説

このコンストラクタは、message パラメータを使用して Message プロパティを初期化し、innerException パラメータを使用して InnerException プロパティを初期化します。

innerException が null 参照 (Visual Basic では Nothing) でない場合は、innerException を処理する catch ブロックで現在の例外が発生します。

使用例

このコンストラクタを呼び出すコード例を次に示します。

C#

public static SmtpException GenerateSmtpException(string
 message, Exception innerException)
{
    return new SmtpException(message, innerException);
}

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

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

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

SmtpException クラスの新しいインスタンスを、指定したエラーメッセージを使用して初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    message As String _
)

Visual Basic (使用法)

Dim message As String

Dim instance As New SmtpException(message)

C#

public SmtpException (
    string message
)

C++

public:
SmtpException (
    String^ message
)

J#

public SmtpException (
    String message
)

JScript

public function SmtpException (
    message : String
)

パラメータ

message: 発生したエラーを説明する String。

解説

このコンストラクタは、message パラメータを使用して Message プロパティを初期化します。

使用例

このコンストラクタを呼び出すコード例を次に示します。

C#

public static SmtpException GenerateSmtpException(string
 message)
{
    return new SmtpException(message);
}

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

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

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

指定したステータスコードとエラーメッセージを使用して、SmtpException クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    statusCode As SmtpStatusCode, _
    message As String _
)

Visual Basic (使用法)

Dim statusCode As SmtpStatusCode
Dim message As String

Dim instance As New SmtpException(statusCode,
 message)

C#

public SmtpException (
    SmtpStatusCode statusCode,
    string message
)

C++

public:
SmtpException (
    SmtpStatusCode statusCode, 
    String^ message
)

J#

public SmtpException (
    SmtpStatusCode statusCode, 
    String message
)

JScript

public function SmtpException (
    statusCode : SmtpStatusCode, 
    message : String
)

パラメータ

statusCode: SmtpStatusCode 値です。

message: 発生したエラーを説明する String。

解説

このコンストラクタは、statusCode パラメータを使用して StatusCode プロパティを初期化し、message パラメータを使用して Message プロパティを初期化します。

使用例

このコンストラクタを呼び出すコード例を次に示します。

C#

public static SmtpException GenerateSmtpException(SmtpStatusCode
 status, string message)
{
    return new SmtpException(status, message);
}

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

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

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

名前	説明
SmtpException ()	SmtpException クラスの新しいインスタンスを初期化します。
SmtpException (SmtpStatusCode)	ステータスコードを指定して、SmtpException クラスの新しいインスタンスを初期化します。
SmtpException (String)	SmtpException クラスの新しいインスタンスを、指定したエラーメッセージを使用して初期化します。
SmtpException (SerializationInfo, StreamingContext)	SerializationInfo クラスと StreamingContext クラスの指定したインスタンスから、SmtpException クラスの新しいインスタンスを初期化します。
SmtpException (SmtpStatusCode, String)	指定したステータスコードとエラーメッセージを使用して、SmtpException クラスの新しいインスタンスを初期化します。
SmtpException (String, Exception)	指定したエラーメッセージと内部例外を使用して、SmtpException クラスの新しいインスタンスを初期化します。

参照

関連項目

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

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

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

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

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

Visual Basic (宣言)

Protected Sub New ( _
    serializationInfo As SerializationInfo, _
    streamingContext As StreamingContext _
)

Visual Basic (使用法)

Dim serializationInfo As SerializationInfo
Dim streamingContext As StreamingContext

Dim instance As New SmtpException(serializationInfo,
 streamingContext)

C#

protected SmtpException (
    SerializationInfo serializationInfo,
    StreamingContext streamingContext
)

C++

protected:
SmtpException (
    SerializationInfo^ serializationInfo, 
    StreamingContext streamingContext
)

J#

protected SmtpException (
    SerializationInfo serializationInfo, 
    StreamingContext streamingContext
)

JScript

protected function SmtpException (
    serializationInfo : SerializationInfo, 
    streamingContext : StreamingContext
)

パラメータ

serializationInfo: 新しい SmtpException をシリアル化するために必要な情報を格納する SerializationInfo。

streamingContext: 新しいインスタンスに関連付けられているシリアル化ストリームのソースおよびデスティネーションを格納する StreamingContext。

解説

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

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

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

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

ステータスコードを指定して、SmtpException クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    statusCode As SmtpStatusCode _
)

Visual Basic (使用法)

Dim statusCode As SmtpStatusCode

Dim instance As New SmtpException(statusCode)

C#

public SmtpException (
    SmtpStatusCode statusCode
)

C++

public:
SmtpException (
    SmtpStatusCode statusCode
)

J#

public SmtpException (
    SmtpStatusCode statusCode
)

JScript

public function SmtpException (
    statusCode : SmtpStatusCode
)

パラメータ

statusCode: SmtpStatusCode 値です。

解説

このコンストラクタは、statusCode パラメータを使用して StatusCode プロパティを初期化します。

使用例

このコンストラクタを呼び出すコード例を次に示します。

C#

public static SmtpException GenerateSmtpException(SmtpStatusCode
 status)
{
    return new SmtpException(status);
}

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

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

パブリックプロパティパブリックプロパティ

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

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

プロテクトプロパティ

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

参照

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

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

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

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

SmtpExceptionとは？わかりやすく解説

SmtpException クラス

SmtpException コンストラクタ ()

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

SmtpException コンストラクタ (String)

SmtpException コンストラクタ (SmtpStatusCode, String)

SmtpException コンストラクタ

関連項目

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

SmtpException コンストラクタ (SmtpStatusCode)

SmtpException プロパティ

関連項目

SmtpException メソッド

関連項目

SmtpException メンバ

関連項目

英和和英テキスト翻訳

「SmtpException」の関連用語


	© 2026 Microsoft.All rights reserved.

SmtpExceptionとは？ わかりやすく解説

SmtpException クラス

SmtpException コンストラクタ ()

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

SmtpException コンストラクタ (String)

SmtpException コンストラクタ (SmtpStatusCode, String)

SmtpException コンストラクタ

関連項目

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

SmtpException コンストラクタ (SmtpStatusCode)

SmtpException プロパティ

関連項目

SmtpException メソッド

関連項目

SmtpException メンバ

関連項目

英和和英テキスト翻訳

「SmtpException」の関連用語

SmtpExceptionとは？わかりやすく解説