PowerTCP Mail for .NET
Add(MailAddress) Method
See Also  Example Send comments on this topic.
Dart.PowerTCP.Mail Namespace > MailAddresses Class > Add Method : Add(MailAddress) Method




Address
A single MailAddress object
Adds a MailAddress object to the MailAddresses collection.

Syntax

Visual Basic (Declaration) 
Public Overloads Function Add( _
   ByVal Address As MailAddress _
) As Integer
Visual Basic (Usage)Copy Code
Dim instance As MailAddresses
Dim Address As MailAddress
Dim value As Integer
 
value = instance.Add(Address)
C# 
public int Add( 
   MailAddress Address
)
Managed Extensions for C++ 
public: int Add( 
   MailAddress* Address
) 
C++/CLI 
public:
int Add( 
   MailAddress^ Address
) 

Parameters

Address
A single MailAddress object

Example

The following example demonstrates the functionality of the MailAddresses collection.
Visual BasicCopy Code
' Be sure to import the namespace by putting "Imports Dart.PowerTCP.Mail"
' at the top of your class.

' Create a MailAddresses collection
Dim ma As New MailAddresses()

' Add a single email address
ma.Add(New MailAddress("address1@test.com"))

' Add a comma delimited list of email addresses.
ma.Add("address2@test.com,address3@test.com")

' Add an otherwise-delimited list of email addresses.
ma.Add("address2@test.com&address3@test.com", "&")

' Remove an email address
ma.Remove("address1@test.com")

' Remove any duplicate email addresses
ma.RemoveDuplicates()

System.Diagnostics.Debug.WriteLine(ma.ToString())

' Output
' ------------------
' <address2@test.com>,<address3@test.com>

' Add some more email addresses
ma.Add("mail1@other.com,mail2@other.com")

' Split the addresses by domain
Dim marray() As MailAddresses = ma.SplitByDomain()

Dim m As MailAddresses
For Each m In marray
   System.Diagnostics.Debug.WriteLine(m.ToString())
Next

' Output
' -----------------
' <mail1@other.com>,<mail2@other.com>
' <address2@test.com>,<address3@test.com>
'
C#Copy Code
// Be sure to import the namespace by putting "using Dart.PowerTCP.Mail;"
// at the top of your class.

// Create a MailAddresses collection
MailAddresses ma = new MailAddresses();

// Add a single email address
ma.Add(new MailAddress("address1@test.com"));

// Add a comma delimited list of email addresses.
ma.Add("address2@test.com,address3@test.com");

// Add an otherwise-delimited list of email addresses.
ma.Add("address2@test.com&address3@test.com", "&");

// Remove an email address
ma.Remove("address1@test.com");

// Remove any duplicate email addresses
ma.RemoveDuplicates();

System.Diagnostics.Debug.WriteLine(ma.ToString());

// Output
// ------------------
// <address2@test.com>,<address3@test.com>

// Add some more email addresses
ma.Add("mail1@other.com,mail2@other.com");

// Split the addresses by domain
MailAddresses[] marray = ma.SplitByDomain();
foreach(MailAddresses m in marray)
   System.Diagnostics.Debug.WriteLine(m.ToString());

// Output
// -----------------
// <mail1@other.com>,<mail2@other.com>
// <address2@test.com>,<address3@test.com>
//

Remarks

Standard usage of this overload would involve creating a MailAddress object, setting the properties of the MailAddress object (if desired) and adding the MailAddress object to the MailAddress collection.

Requirements

Target Platforms: Microsoft .NET Framework 2.0

See Also

Documentation Version 3.2
© 2010 Dart Communications. All Rights Reserved.