Click to Rate and Give Feedback
MSDN
MSDN Library
.NET Development
.NET Framework 3.5
Add Method
 Add Method (String)

  Switch on low bandwidth view
This page is specific to
Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:
.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)
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 (",").
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.

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

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.

.NET Framework

Supported in: 3.5, 3.0, 2.0
Tags What's this?: Add a tag
Community Content   What is Community Content?
Add new content RSS  Annotations
Problem with encodings      Escape   |   Edit   |   Show History

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 What's this?: bug (x) Add a tag
Flag as ContentBug
mail address validation error      gauthier ... Thomas Lee   |   Edit   |   Show History
I get FormatException with addresses such as name..something@server.com however this is perfectly legit address
Why comma?      mcgmatt   |   Edit   |   Show History

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 What's this?: Add a tag
Flag as ContentBug
Processing
© 2009 Microsoft Corporation. All rights reserved. Terms of Use  |  Trademarks  |  Privacy Statement
Page view tracker