MailAddress クラス

定義

public ref class MailAddress

public class MailAddress

type MailAddress = class

Public Class MailAddress

継承

Object

MailAddress

例

次のコード例は、、、およびクラスを使用して電子メールメッセージを送信する方法を示して SmtpClient MailAddress MailMessage います。The following code example demonstrates sending an email message by using the SmtpClient, MailAddress, and MailMessage classes.

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 電子メールメッセージのアドレス情報を格納するために使用されます。The MailAddress class is used by the SmtpClient and MailMessage classes to store address information for email messages.

メールアドレスは、 User 名前 Host と名前、および必要に応じて、で構成され DisplayName ます。A mail address is composed of a User name, Host name and optionally, a DisplayName. DisplayNameエンコードする場合、には ASCII 以外の文字を含めることができます。The DisplayName can contain non-ASCII characters if you encode them.

クラスは、 MailAddress 次のメールアドレス形式をサポートしています。The MailAddress class supports the following mail address formats:

• の単純なアドレス形式 user@host 。A simple address format of user@host. DisplayNameが設定されていない場合は、生成されたメールアドレスの形式です。If a DisplayName is not set, this is the mail address format generated.

• の標準の引用符で囲まれた表示名の形式 "display name" <user@host> 。A standard quoted display name format of "display name" <user@host>. が設定されている場合 DisplayName は、これが生成された形式になります。If a DisplayName is set, this is the format generated.

• Userこれらが含まれていない場合は、名前と名前の周りに山かっこが追加され Host ます。Angle brackets are added around the User name and Host name, if these are not included. たとえば、 "display name" user@host はに変更され "display name" <user@host> ます。For example, "display name" user@host is changed to "display name" <user@host>.

• が DisplayName 含まれていない場合は、の周りに引用符が追加されます。Quotes are added around the DisplayName, if these are not included. たとえば、 display name <user@host> はに変更され "display name" <user@host> ます。For example, display name <user@host> is changed to "display name" <user@host>.

• Unicode 文字は、プロパティでサポートされてい DisplayName ます。Unicode characters are supported in the DisplayName property.

• User引用符付きの名前。A User name with quotes. たとえば、"user name"@host のようにします。For example, "user name"@host.

• ユーザー名の連続したドットと末尾のドット。Consecutive and trailing dots in user names. たとえば、user...name..@host のようにします。For example, user...name..@host.

• 角かっこで囲まれたドメインリテラル。Bracketed domain literals. たとえば、<user@[my domain]> のようにします。For example, <user@[my domain]>.

• [コメント]: Comments. たとえば、(comment)"display name"(comment)<(comment)user(comment)@(comment)domain(comment)>(comment) のようにします。For example, (comment)"display name"(comment)<(comment)user(comment)@(comment)domain(comment)>(comment). コメントは転送前に削除されます。Comments are removed before transmission.

コンマは、メールアドレスのリスト内の要素を区切るために使用されます。A comma is used to separate elements in a list of mail addresses. そのため、リスト内の引用符で囲まれていない表示名にはコンマを使用しないでください。As a result, a comma should not be used in unquoted display names in a list. 次のメールアドレスが許可されます。The following mail addresses would be allowed:

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

次のメールアドレスは使用できません:The following mail address would not be allowed:

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

引用符は引用符で囲まれた文字列に埋め込むことができますが、エスケープする必要があります。Quotes can be embedded in a quoted string, but they must be escaped. 次のメールアドレスが許可されます。The following mail addresses would be allowed:

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

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

次のメールアドレスは使用できません:The following mail address would not be allowed:

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

ユーザー名が引用符で囲まれていない場合、文字列 (またはコンマ) の先頭とアドレスの間にあるすべてのテキストは、コメントを含め、の一部と見なされ DisplayName ます。When the username is not quoted, all text between the start of the string (or comma) and the address are considered part of the DisplayName, including comments. 次に例を示します。For example:

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

クラスは MailAddress メールアドレスを有効なものとして受け入れますが、他のメールサーバーはメールアドレスを受け付けない可能性があります。Although the MailAddress class accepts a mail address as valid, other mail servers may not accept the mail address.

MailAddressクラスは、次のメールアドレス形式をサポートしていません。The MailAddress class does not support the following mail address formats:

• 引用符付きおよび引用符で囲まれていない表示名。Mixed quoted and unquoted display names. たとえば、display "name" <user@host> のようにします。For example, display "name" <user@host>.

• IETF によって発行された RFC 2822 セクション3.4 で定義されているグループ。Groups, as defined in RFC 2822 Section 3.4 published by the IETF.

• "user"."name"@host、、またはの不使用のユーザー名形式 user."name"@host "user".name@host 。The obsolete user name formats of "user"."name"@host, user."name"@host or "user".name@host.

コンストラクター

プロパティ

メソッド

適用対象