Skip to content

Commit d4a3c0c

Browse files
authored
MailAddress: Clarify formatting elements versus details of them. (#9837)
1 parent 18c03ac commit d4a3c0c

File tree

1 file changed

+6
-4
lines changed

1 file changed

+6
-4
lines changed

xml/System.Net.Mail/MailAddress.xml

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -58,18 +58,20 @@ The <xref:System.Net.Mail.MailAddress> class is used by the <xref:System.Net.Mai
5858
5959
A mail address is composed of a <xref:System.Net.Mail.MailAddress.User%2A> name, <xref:System.Net.Mail.MailAddress.Host%2A> name and optionally, a <xref:System.Net.Mail.MailAddress.DisplayName%2A>. The <xref:System.Net.Mail.MailAddress.DisplayName%2A> can contain non-ASCII characters if you encode them.
6060
61-
The <xref:System.Net.Mail.MailAddress> class supports the following mail address formats:
61+
The <xref:System.Net.Mail.MailAddress> class supports the following mail address formats:
6262
6363
- A simple address format of `user@host`. If a <xref:System.Net.Mail.MailAddress.DisplayName%2A> is not set, this is the mail address format generated.
6464
6565
- A standard quoted display name format of `"display name" <user@host>`. If a <xref:System.Net.Mail.MailAddress.DisplayName%2A> is set, this is the format generated.
6666
67-
- Angle brackets are added around the <xref:System.Net.Mail.MailAddress.User%2A> name and <xref:System.Net.Mail.MailAddress.Host%2A> name, if these are not included. For example, `"display name" user@host` is changed to `"display name" <user@host>`.
67+
- Angle brackets are added around the <xref:System.Net.Mail.MailAddress.User%2A> name and <xref:System.Net.Mail.MailAddress.Host%2A> name, if these are not included. For example, `"display name" user@host` is changed to `"display name" <user@host>`.
6868
69-
- Quotes are added around the <xref:System.Net.Mail.MailAddress.DisplayName%2A>, if these are not included. For example, `display name <user@host>` is changed to `"display name" <user@host>`.
69+
- Quotes are added around the <xref:System.Net.Mail.MailAddress.DisplayName%2A>, if these are not included. For example, `display name <user@host>` is changed to `"display name" <user@host>`.
7070
71-
- Unicode characters are supported in the <xref:System.Net.Mail.MailAddress.DisplayName%2A> property.
71+
- Unicode characters are supported in the <xref:System.Net.Mail.MailAddress.DisplayName%2A> property.
7272
73+
Within these two formats, the following elements are allowed:
74+
7375
- A <xref:System.Net.Mail.MailAddress.User%2A> name with quotes. For example, `"user name"@host`.
7476
7577
- Consecutive and trailing dots in user names. For example, `user...name..@host`.

0 commit comments

Comments
 (0)