MailAddress クラス

リファレンス

定義

名前空間:: System.Net.Mail

アセンブリ:: System.Net.Mail.dll

アセンブリ:: System.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

public ref class MailAddress

public class MailAddress

type MailAddress = class

Public Class MailAddress

継承: Object
MailAddress

例

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

static void CreateCopyMessage( String^ server )
{
   MailAddress^ from = gcnew MailAddress( L"ben@contoso.com",L"Ben Miller" );
   MailAddress^ to = gcnew MailAddress( L"jane@contoso.com",L"Jane Clayton" );
   MailMessage^ message = gcnew MailMessage( from,to );
   
   // message.Subject = "Using the SmtpClient class.";
   message->Subject = L"Using the SmtpClient class.";
   message->Body = L"Using this feature, you can send an email message from an application very easily.";
   
   // Add a carbon copy recipient.
   MailAddress^ copy = gcnew MailAddress( L"Notification_List@contoso.com" );
   message->CC->Add( copy );
   SmtpClient^ client = gcnew SmtpClient( server );
   
   // Include credentials if the server requires them.
   client->Credentials = CredentialCache::DefaultNetworkCredentials;
   Console::WriteLine( L"Sending an email message to {0} by using the SMTP host {1}.", to->Address, client->Host );
   client->Send( message );
   client->~SmtpClient();
}

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 email 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 email message to {0} by using the SMTP host {1}.",
         to.Address, client.Host);

    try
    {
        client.Send(message);
    }
    catch (Exception ex)
    {
        Console.WriteLine("Exception caught in CreateCopyMessage(): {0}",
            ex.ToString());
    }
}

注釈

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

メールアドレスは、 User 名前、名前、 Host 必要に DisplayName応じて . エンコードする場合は DisplayName 、ASCII 以外の文字を含めることができます。

このクラスでは MailAddress 、次のメールアドレス形式がサポートされています。

の単純なアドレス形式 user@host。 a DisplayName が設定されていない場合、これは生成されるメールアドレス形式です。
標準の引用符で囲まれた表示名の "display name" <user@host>形式です。 a DisplayName が設定されている場合、これは生成される形式です。
山かっこが含まれていない場合は、名前とHost名前のUser周囲に山かっこが追加されます。たとえば、次 "display name" user@host に "display name" <user@host>変更します。
引用符が含まれていない場合は、引用符の DisplayName周囲に追加されます。たとえば、次 display name <user@host> に "display name" <user@host>変更します。
このプロパティでは、Unicode 文字が DisplayName サポートされています。
User引用符付きの名前。たとえば、「 "user name"@host 」のように入力します。
ユーザー名の連続するドットと末尾のドット。たとえば、「 user...name..@host 」のように入力します。
角かっこで囲まれたドメインリテラル。たとえば、「 <user@[my domain]> 」のように入力します。
[コメント]: たとえば、「 (comment)"display name"(comment)<(comment)user(comment)@(comment)domain(comment)>(comment) 」のように入力します。コメントは送信前に削除されます。

コンマは、メールアドレスのリスト内の要素を区切るために使用されます。その結果、リスト内の引用符で囲まれていない表示名にはコンマを使用しないでください。次のメールアドレスが許可されます。

"John, Doe" <user@host>, "Bob, Smith" <user2@host>

次のメールアドレスは許可されません。

John, Doe <user@host>, Bob, Smith <user2@host>

引用符は引用符で囲まれた文字列に埋め込むことができますが、エスケープする必要があります。次のメールアドレスが許可されます。

"John \"Jr\" Doe" <user@host>

"\"John \\\"Jr\\\" Doe\" <user@host>"

次のメールアドレスは許可されません。

"John "Jr" Doe" <user@host>

ユーザー名が引用符で囲まれていない場合、文字列の先頭 (またはコンマ) とアドレスの間のすべてのテキストは、コメントを DisplayName含む一部と見なされます。次に例を示します。

(non comment) unquoted display (non comment) name (non comment) <user@host>

クラスは MailAddress 、有効なメールアドレスを受け入れますが、他のメールサーバーはメールアドレスを受け入れられない場合があります。

このクラスでは MailAddress 、次のメールアドレス形式はサポートされていません。

引用符で囲まれた表示名と引用符で囲まれていない表示名の混在。たとえば、「 display "name" <user@host> 」のように入力します。
IETF によって公開された RFC 2822 セクション 3.4 で定義されているグループ。
の古いユーザー名形式"user"."name"@host``user."name"@host。または "user".name@host.

コンストラクター

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

プロパティ

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

メソッド

Equals(Object)	2 つのメールアドレスを比較します。
GetHashCode()	メールアドレスのハッシュ値を返します。
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
ToString()	このインスタンスの文字列形式を返します。
TryCreate(String, MailAddress)	新しい MailAddress を作成します。オブジェクトを作成できない場合でも、例外はスローされません。
TryCreate(String, String, Encoding, MailAddress)	新規の MailAddress を作成します。オブジェクトを作成できない場合でも、例外はスローされません。
TryCreate(String, String, MailAddress)	新規の MailAddress を作成します。オブジェクトを作成できない場合でも、例外はスローされません。

適用対象

MailAddress クラス

定義

例

注釈

コンストラクター

プロパティ

メソッド

適用対象

その他のリソース