MailAddress.ToString メソッド

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

MailAddress.ToString メソッド

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

このインスタンスの文字列形式を返します。

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

Visual Basic (宣言)

Public Overrides Function
 ToString As String

Visual Basic (使用法)

Dim instance As MailAddress
Dim returnValue As String

returnValue = instance.ToString

C#

public override string ToString ()

C++

public:
virtual String^ ToString () override

J#

public String ToString ()

JScript

public override function ToString () : String

戻り値
この MailAddress の内容を格納している String。

解説

このメソッドで返される文字列は、必ずしもインスタンスが作成されたときに指定された文字列と同じではありません。DisplayName プロパティが null 参照 (Visual Basic では Nothing) でなく String.Empty ("") とも等しくない場合、ToString は、次の構文を使用して作成した文字列を返します。

DisplayName <User@Host>

DisplayName が null 参照 (Visual Basic では Nothing) であるか String.Empty と等しい場合、ToString は、Address プロパティの値を返します。

非 ASCII 文字を含んだ表示名は、エンコードされた形式で返されます。非 ASCII 文字のエンコーディングは、RFC 1522 (http://www.ietf.org を参照) に記述されています。

使用例

電子メール メッセージの送信先を表示するコード例を次に示します。

C#

public static void CreateTestMessage4(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.Body = @"Using this feature, you can send an
 e-mail message from an application very easily.";
    SmtpClient client = new SmtpClient(server);
    Console.WriteLine("Sending an e-mail message to {0} by using
 SMTP host {1} port {2}.",
         to.ToString(), client.Host, client.Port);
    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 名前空間