.NET Framework Class Library
MailAddressCollection..::.Add Method (String)

Add a list of e-mail addresses to the collection.

Namespace:  System.Net.Mail
Assembly:  System (in System.dll)
Syntax
Visual Basic (Declaration) 
Public Sub Add ( _
    addresses As String _
)
Visual Basic (Usage) 
Dim instance As MailAddressCollection
Dim addresses As String

instance.Add(addresses)
C# 
public void Add(
    string addresses
)
Visual C++ 
public:
void Add(
    String^ addresses
)
JScript 
public function Add(
    addresses : String
)

Parameters

addresses
Type: System..::.String
The e-mail addresses to add to the MailAddressCollection. Multiple e-mail addresses must be separated with a comma character (",").
Exceptions
ExceptionCondition
ArgumentNullException

The addresses parameter is null.

ArgumentException

The addresses parameter is an empty string.

FormatException

The addresses parameter contains an e-mail address that is invalid or not supported.

Remarks

If multiple e-mail addresses separated with a semicolon character (";") are passed in the addresses parameter. a FormatException exception is raised.
Platforms

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.
Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0
See Also

Reference

MailAddressCollection Class
MailAddressCollection Members
Add Overload
System.Net.Mail Namespace
Tags :


Community Content

Escape
Problem with encodings

It seems that this version of the method does not support characters that need to be encoded in the display name, it raises a IndexOutOfRangeException in System.Net.Mime.MailBnfHelper.ReadQuotedString(string data, ref int offset, System.Text.StringBuilder builder, bool doesntRequireQuotes).

Call the other overload this way :

MailAddressCollection addresses = new MailAddressCollection();
addresses.Add(new MailAddress(address));


Tags : bug

Thomas Lee
mail address validation error
I get FormatException with addresses such as name..something@server.com however this is perfectly legit address
Tags : productbug?

mcgmatt
Why comma?

Outlook uses a semi-colon to separate e-mail addresses, and the SMTP RFC says to use the semi-colon. You can even assign addresses like: message.To = "address;address"; So it's strange that this method's addresses parameter expects commas as a separators. (If you had to choose one character, why choose the one that is less standard?)

Tags :

timschwallie
Why comma?

''

ps: that's the standard for Ditto.


Didn't some old email addresses in the past include commas? Was it Compuserve?

Tags :

Page view tracker