MailAddress Constructor (String)

 

Initializes a new instance of the MailAddress class using the specified address.

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

Public Sub New (
	address As String
)

Parameters

address
Type: System.String

A String that contains an e-mail address.

Exception Condition
ArgumentNullException

address is null.

ArgumentException

address is String.Empty ("").

FormatException

address is not in a recognized format.

The address parameter can contain a display name and the associated e-mail address if you enclose the address in angle brackets. For example:

"Tom Smith <tsmith@contoso.com>"

White space is permitted between the display name and the angle brackets.

The following table shows the property values for a MailAddress object constructed using the preceding example address.

Property

Value

DisplayName

"Tom Smith"

Host

"contoso.com"

User

"tsmith"

Address

"tsmith@contoso.com"

The following code example uses this constructor to create a MailAddress object for the Bcc recipient of an e-mail message.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 2.0
Return to top
Show: