MailAddress クラス

定義

電子メールの差出人または受信者のアドレスを表します。Represents the address of an electronic mail sender or recipient.

public ref class MailAddress
public class MailAddress
type MailAddress = class
Public Class MailAddress
継承
MailAddress

次のコード例は、SmtpClientMailAddress、および 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>.

  • DisplayName プロパティでは、Unicode 文字がサポートされています。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"@hostuser."name"@host または "user".name@hostの不使用のユーザー名形式。The obsolete user name formats of "user"."name"@host, user."name"@host or "user".name@host.

コンストラクター

MailAddress(String)

指定したアドレスを使用して、MailAddress クラスの新しいインスタンスを初期化します。Initializes a new instance of the MailAddress class using the specified address.

MailAddress(String, String)

アドレスと表示名を指定して、MailAddress クラスの新しいインスタンスを初期化します。Initializes a new instance of the MailAddress class using the specified address and display name.

MailAddress(String, String, Encoding)

アドレス、表示名、およびエンコーディングを指定して、MailAddress クラスの新しいインスタンスを初期化します。Initializes a new instance of the MailAddress class using the specified address, display name, and encoding.

プロパティ

Address

このインスタンスが作成されたときに指定された電子メール アドレスを取得します。Gets the email address specified when this instance was created.

DisplayName

このインスタンスが作成されたときに指定された表示名とアドレス情報で構成される表示名を取得します。Gets the display name composed from the display name and address information specified when this instance was created.

Host

このインスタンスが作成されたときに指定されたアドレスのホスト部分を取得します。Gets the host portion of the address specified when this instance was created.

User

このインスタンスが作成されたときに指定されたアドレスからユーザー情報を取得します。Gets the user information from the address specified when this instance was created.

メソッド

Equals(Object)

2 つのメール アドレスを比較します。Compares two mail addresses.

GetHashCode()

メール アドレスのハッシュ値を返します。Returns a hash value for a mail address.

GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(継承元 Object)
MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(継承元 Object)
ToString()

このインスタンスの文字列形式を返します。Returns a string representation of this instance.

適用対象