Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

MailAddress.MailAddress(String, String, Encoding) Constructor

Initializes a new instance of the MailAddress class using the specified address, display name, and encoding.

Namespace: System.Net.Mail
Assembly: System (in system.dll)

public MailAddress (
	string address,
	string displayName,
	Encoding displayNameEncoding
)
public MailAddress (
	String address, 
	String displayName, 
	Encoding displayNameEncoding
)
public function MailAddress (
	address : String, 
	displayName : String, 
	displayNameEncoding : Encoding
)
Not applicable.

Parameters

address

A String that contains an e-mail address.

displayName

A String that contains the display name associated with address.

displayNameEncoding

The Encoding that defines the character set used for displayName.

Exception typeCondition

ArgumentNullException

address is a null reference (Nothing in Visual Basic).

-or-

displayName is a null reference (Nothing in Visual Basic).

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 a null reference (Nothing in Visual Basic) 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.

// Create a mailing address that includes a UTF8 character
// in the display name.
MailAddress from = new MailAddress("jane@contoso.com", 
   "Jane " + (char)0xD8+ " Clayton", 
System.Text.Encoding.UTF8);

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

Show:
© 2014 Microsoft