MailAddress Constructor (String, String, Encoding)
Initializes a new instance of the MailAddress class using the specified address, display name, and encoding.
Assembly: System (in System.dll)
public:
MailAddress(
String^ address,
String^ displayName,
Encoding^ displayNameEncoding
)
Parameters
- address
- Type: System::String
A String that contains an e-mail address.
- displayName
- Type: System::String
A String that contains the display name associated with address.
- displayNameEncoding
- Type: System.Text::Encoding
The Encoding that defines the character set used for displayName.
| Exception | Condition |
|---|---|
| ArgumentNullException | address is nullptr. -or- displayName is nullptr. |
| ArgumentException | address is String::Empty (""). -or- displayName is String::Empty (""). |
| FormatException | address is not in a recognized format. -or- address contains non-ASCII characters. |
Leading and trailing white space in the display name is preserved.
If address contains a display name, and displayName is not nullptr and is not equal to String::Empty, displayName overrides the value specified in address.
The following code example uses this constructor to create MailAddress instances for the sender of an e-mail message.
Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.