MailAddress MailAddress MailAddress MailAddress Class

定義

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

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

次のコード例は、 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() );
	  }
  }

注釈

クラスは、 SmtpClient およびMailMessageクラスによって、電子メールメッセージのアドレス情報を格納するために使用されます。 MailAddressThe 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.

  • 引用符付きの名前。 UserA 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.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.

コンストラクター

MailAddress(String) MailAddress(String) MailAddress(String) MailAddress(String)

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

MailAddress(String, String) MailAddress(String, String) MailAddress(String, String) MailAddress(String, String)

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

MailAddress(String, String, Encoding) MailAddress(String, String, Encoding) MailAddress(String, String, Encoding) MailAddress(String, String, Encoding)

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

プロパティ

Address Address Address Address

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

DisplayName DisplayName DisplayName DisplayName

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

Host Host Host Host

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

User User User User

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

メソッド

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

GetType() GetType() GetType() GetType()

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

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
ToString() ToString() ToString() ToString()

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

適用対象