Click to Rate and Give Feedback
MSDN
MSDN Library
.NET Development
.NET Framework 3.5
Add Method
 Add Method (String)
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 Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, 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   |  

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   |  
I get FormatException with addresses such as name..something@server.com however this is perfectly legit address
Processing
© 2008 Microsoft Corporation. All rights reserved. Terms of Use  |  Trademarks  |  Privacy Statement
Page view tracker