「MailAddress」の意味や使い方わかりやすく解説 Weblio辞書 (original) (raw)

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

関連項目
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)

public MailAddress ( string address, string displayName )

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

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 インスタンスを生成するコード例を次に示します。

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

関連項目
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)

public MailAddress ( string address )

public: MailAddress ( String^ address )

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 オブジェクトを生成するコード例を次に示します。

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

関連項目
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)

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

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

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 文字が格納されています。

解説

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

使用例

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

// 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);

// 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

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

MailAddress コンストラクタ

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

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

MailAddress プロパティ

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

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