MailAddress

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

MailAddress クラス

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

電子メールの差出人または受信者のアドレスを表します。

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

Visual Basic (宣言)

Public Class MailAddress

Visual Basic (使用法)

Dim instance As MailAddress

C#

public class MailAddress

C++

public ref class MailAddress

J#

public class MailAddress

JScript

public class MailAddress

解説

MailAddress クラスは SmtpClient クラスと MailMessage クラスによって使用され、電子メールのアドレス情報を格納します。

メール アドレスは、User 名、Host 名、および必要に応じて DisplayName で構成されます。エンコードすると、DisplayName に非 ASCII 文字を格納できます。

使用例

SmtpClient、MailAddress、および MailMessage の各クラスを使用して電子メール メッセージを送信するコード例を次に示します。

C#

public static void CreateCopyMessage(string
 server)
{
    MailAddress from = new MailAddress("ben@contoso.com",
 "Ben Miller");
    MailAddress to = new MailAddress("jane@contoso.com",
 "Jane Clayton");
    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("Notification_List@contoso.com");
    message.CC.Add(copy);
    SmtpClient client = new SmtpClient(server);
    // Include credentials if the server requires them.
    client.Credentials = CredentialCache.DefaultNetworkCredentials;
    Console.WriteLine("Sending an e-mail message to {0} by using
 the SMTP host {1}.",
         to.Address, client.Host);
    client.Send(message);
}

継承階層

System.Object
  System.Net.Mail.MailAddress

スレッド セーフ

この型の 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

参照

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

MailAddress コンストラクタ (String, String)

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

アドレスと表示名を指定して、MailAddress クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    address As String, _
    displayName As String _
)

Visual Basic (使用法)

Dim address As String
Dim displayName As String

Dim instance As New MailAddress(address,
 displayName)

C#

public MailAddress (
    string address,
    string displayName
)

C++

public:
MailAddress (
    String^ address, 
    String^ displayName
)

J#

public MailAddress (
    String address, 
    String displayName
)

JScript

public function MailAddress (
    address : String, 
    displayName : String
)

パラメータ

address

電子メール アドレスを格納している String。

displayName

address に関連付けられた表示名を格納している String。このパラメータは、null 参照 (Visual Basic では Nothing) の場合もあります。

例外

例外の種類	条件
ArgumentNullException	address が null 参照 (Visual Basic では Nothing) です。
ArgumentException	address が String.Empty ("") です。
FormatException	address が、認識されている形式ではありません。 または address に非 ASCII 文字が格納されています。

解説

表示名の前後の空白は保持されます。

displayName に非 ASCII 文字が格納されている場合、displayName エンコーディングに iso-8859-1 文字セットが使用されます。非 ASCII 文字のエンコーディングは、RFC 1522 (http://www.ietf.org を参照) に記述されています。

address に表示名が格納されていて、displayName が null 参照 (Visual Basic では Nothing) でなく String.Empty とも等しくない場合、displayName が address に指定された値をオーバーライドします。

使用例

このコンストラクタを使用して電子メール メッセージの差出人および受信者の MailAddress インスタンスを生成するコード例を次に示します。

C#

public static void CreateBccTestMessage(string
 server)
{
    MailAddress from = new MailAddress("ben@contoso.com",
 "Ben Miller");
    MailAddress to = new MailAddress("jane@contoso.com",
 "Jane Clayton");
    MailMessage message = new MailMessage(from, to);
    message.Subject = "Using the SmtpClient class.";
    message.Body = @"Using this feature, you can send an
 e-mail message from an application very easily.";
    MailAddress bcc = new MailAddress("manager1@contoso.com");
    message.Bcc.Add(bcc);
    SmtpClient client = new SmtpClient(server);
    client.Credentials = CredentialCache.DefaultNetworkCredentials;
    Console.WriteLine("Sending an e-mail message to {0} and {1}.", to.DisplayName,
 message.Bcc.ToString());
    client.Send(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

参照

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

MailAddress コンストラクタ (String)

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

アドレスを指定して、MailAddress クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    address As String _
)

Visual Basic (使用法)

Dim address As String

Dim instance As New MailAddress(address)

C#

public MailAddress (
    string address
)

C++

public:
MailAddress (
    String^ address
)

J#

public MailAddress (
    String address
)

JScript

public function MailAddress (
    address : String
)

パラメータ

address

電子メール アドレスを格納している String。

例外

例外の種類	条件
ArgumentNullException	address が null 参照 (Visual Basic では Nothing) です。
ArgumentException	address が String.Empty ("") です。
FormatException	address が、認識されている形式ではありません。

解説

電子メール アドレスを山かっこで囲むと、address パラメータに表示名および関連付けられた電子メール アドレスを格納できます。次に例を示します。

"Tom Smith <tsmith@contoso.com>"

表示名と山かっこの間には空白を指定できます。

前の例のアドレスを使用して生成された MailAddress オブジェクトのプロパティ値を次の表に示します。

プロパティ	値
DisplayName	"Tom Smith"
Host	"contoso.com"
User	"tsmith"
Address	"tsmith@contoso.com"

使用例

このコンストラクタを使用して、電子メール メッセージの Bcc 受信者の MailAddress オブジェクトを生成するコード例を次に示します。

C#

public static void CreateBccTestMessage(string
 server)
{
    MailAddress from = new MailAddress("ben@contoso.com",
 "Ben Miller");
    MailAddress to = new MailAddress("jane@contoso.com",
 "Jane Clayton");
    MailMessage message = new MailMessage(from, to);
    message.Subject = "Using the SmtpClient class.";
    message.Body = @"Using this feature, you can send an
 e-mail message from an application very easily.";
    MailAddress bcc = new MailAddress("manager1@contoso.com");
    message.Bcc.Add(bcc);
    SmtpClient client = new SmtpClient(server);
    client.Credentials = CredentialCache.DefaultNetworkCredentials;
    Console.WriteLine("Sending an e-mail message to {0} and {1}.", to.DisplayName,
 message.Bcc.ToString());
    client.Send(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

参照

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

MailAddress コンストラクタ (String, String, Encoding)

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

アドレス、表示名、およびエンコーディングを指定して、MailAddress クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    address As String, _
    displayName As String, _
    displayNameEncoding As Encoding _
)

Visual Basic (使用法)

Dim address As String
Dim displayName As String
Dim displayNameEncoding As Encoding

Dim instance As New MailAddress(address,
 displayName, displayNameEncoding)

C#

public MailAddress (
    string address,
    string displayName,
    Encoding displayNameEncoding
)

C++

public:
MailAddress (
    String^ address, 
    String^ displayName, 
    Encoding^ displayNameEncoding
)

J#

public MailAddress (
    String address, 
    String displayName, 
    Encoding displayNameEncoding
)

JScript

public function MailAddress (
    address : String, 
    displayName : String, 
    displayNameEncoding : Encoding
)

パラメータ

address

電子メール アドレスを格納している String。

displayName

address に関連付けられた表示名を格納している String。

displayNameEncoding

displayName で使用される文字セットを定義する Encoding。

例外

例外の種類	条件
ArgumentNullException	address が null 参照 (Visual Basic では Nothing) です。 または displayName が null 参照 (Visual Basic では Nothing) です。
ArgumentException	address が String.Empty ("") です。 または displayName が String.Empty ("") です。
FormatException	address が、認識されている形式ではありません。 または address に非 ASCII 文字が格納されています。

解説

表示名の前後の空白は保持されます。

address に表示名が格納されていて、displayName が null 参照 (Visual Basic では Nothing) でなく String.Empty とも等しくない場合、displayName が address に指定された値をオーバーライドします。

使用例

このコンストラクタを使用して電子メール メッセージの差出人の MailAddress インスタンスを生成するコード例を次に示します。

C#

// Create a mailing address that includes a UTF8 character
// in the display name.
MailAddress from = new MailAddress("jane@contoso.com",
 
   "Jane " + (char)0xD8+ " Clayton", 
System.Text.Encoding.UTF8);

C++

// Create a mailing address that includes a UTF8 
// character in the display name.
MailAddress^ from = gcnew MailAddress("jane@contoso.com",
    "Jane " + (wchar_t)0xD8 + " Clayton",
    System::Text::Encoding::UTF8);

プラットフォーム

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

参照

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

MailAddress コンストラクタ

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

名前	説明
MailAddress (String)	アドレスを指定して、MailAddress クラスの新しいインスタンスを初期化します。
MailAddress (String, String)	アドレスと表示名を指定して、MailAddress クラスの新しいインスタンスを初期化します。
MailAddress (String, String, Encoding)	アドレス、表示名、およびエンコーディングを指定して、MailAddress クラスの新しいインスタンスを初期化します。

参照

関連項目

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

MailAddress プロパティ

パブリック プロパティ

	名前	説明
	Address	このインスタンスが作成されたときに指定された電子メール アドレスを取得します。
	DisplayName	このインスタンスが作成されたときに指定された表示名とアドレス情報で構成される表示名を取得します。
	Host	このインスタンスが作成されたときに指定されたアドレスのホスト部分を取得します。
	User	このインスタンスが作成されたときに指定されたアドレスからユーザー情報を取得します。

参照

関連項目

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

MailAddress メソッド

パブリック メソッド

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

	名前	説明
	Equals	オーバーロードされます。 オーバーライドされます。
	GetHashCode	オーバーライドされます。 メール アドレスのハッシュ値を返します。
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	オーバーライドされます。 このインスタンスの文字列形式を返します。

プロテクト メソッド

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

参照

関連項目

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

MailAddress メンバ

電子メールの差出人または受信者のアドレスを表します。

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

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

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

パブリック プロパティ

	名前	説明
	Address	このインスタンスが作成されたときに指定された電子メール アドレスを取得します。
	DisplayName	このインスタンスが作成されたときに指定された表示名とアドレス情報で構成される表示名を取得します。
	Host	このインスタンスが作成されたときに指定されたアドレスのホスト部分を取得します。
	User	このインスタンスが作成されたときに指定されたアドレスからユーザー情報を取得します。

パブリック メソッド

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

	名前	説明
	Equals	オーバーロードされます。 オーバーライドされます。
	GetHashCode	オーバーライドされます。 メール アドレスのハッシュ値を返します。
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	オーバーライドされます。 このインスタンスの文字列形式を返します。

プロテクト メソッド

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

参照

関連項目

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