MailAddressCollection Class
Store e-mail addresses that are associated with an e-mail message.
System.Collections.ObjectModel::Collection<MailAddress>
System.Net.Mail::MailAddressCollection
Assembly: System (in System.dll)
The MailAddressCollection type exposes the following members.
| Name | Description | |
|---|---|---|
![]() | MailAddressCollection | Initializes an empty instance of the MailAddressCollection class. |
| Name | Description | |
|---|---|---|
![]() | Count | Gets the number of elements actually contained in the Collection<T>. (Inherited from Collection<T>.) |
![]() | Item | Gets or sets the element at the specified index. (Inherited from Collection<T>.) |
![]() | Items | Gets a IList<T> wrapper around the Collection<T>. (Inherited from Collection<T>.) |
| Name | Description | |
|---|---|---|
![]() | Add(T) | Adds an object to the end of the Collection<T>. (Inherited from Collection<T>.) |
![]() | Add(String) | Add a list of e-mail addresses to the collection. |
![]() | Clear | Removes all elements from the Collection<T>. (Inherited from Collection<T>.) |
![]() | ClearItems | Removes all elements from the Collection<T>. (Inherited from Collection<T>.) |
![]() | Contains | Determines whether an element is in the Collection<T>. (Inherited from Collection<T>.) |
![]() | CopyTo | Copies the entire Collection<T> to a compatible one-dimensional Array, starting at the specified index of the target array. (Inherited from Collection<T>.) |
![]() | Equals(Object) | Determines whether the specified Object is equal to the current Object. (Inherited from Object.) |
![]() | Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) |
![]() | GetEnumerator | Returns an enumerator that iterates through the Collection<T>. (Inherited from Collection<T>.) |
![]() | GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
![]() | GetType | Gets the Type of the current instance. (Inherited from Object.) |
![]() | IndexOf | Searches for the specified object and returns the zero-based index of the first occurrence within the entire Collection<T>. (Inherited from Collection<T>.) |
![]() | Insert | Inserts an element into the Collection<T> at the specified index. (Inherited from Collection<T>.) |
![]() | InsertItem | Inserts an e-mail address into the MailAddressCollection, at the specified location. (Overrides Collection<T>::InsertItem(Int32, T).) |
![]() | MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
![]() | Remove | Removes the first occurrence of a specific object from the Collection<T>. (Inherited from Collection<T>.) |
![]() | RemoveAt | Removes the element at the specified index of the Collection<T>. (Inherited from Collection<T>.) |
![]() | RemoveItem | Removes the element at the specified index of the Collection<T>. (Inherited from Collection<T>.) |
![]() | SetItem | Replaces the element at the specified index. (Overrides Collection<T>::SetItem(Int32, T).) |
![]() | ToString | Returns a string representation of the e-mail addresses in this MailAddressCollection object. (Overrides Object::ToString().) |
| Name | Description | |
|---|---|---|
![]() ![]() | ICollection::CopyTo | Copies the elements of the ICollection to an Array, starting at a particular Array index. (Inherited from Collection<T>.) |
![]() ![]() | ICollection<T>::IsReadOnly | Gets a value indicating whether the ICollection<T> is read-only. (Inherited from Collection<T>.) |
![]() ![]() | ICollection::IsSynchronized | Gets a value indicating whether access to the ICollection is synchronized (thread safe). (Inherited from Collection<T>.) |
![]() ![]() | ICollection::SyncRoot | Gets an object that can be used to synchronize access to the ICollection. (Inherited from Collection<T>.) |
![]() ![]() | IEnumerable::GetEnumerator | Returns an enumerator that iterates through a collection. (Inherited from Collection<T>.) |
![]() ![]() | IList::Add | Adds an item to the IList. (Inherited from Collection<T>.) |
![]() ![]() | IList::Contains | Determines whether the IList contains a specific value. (Inherited from Collection<T>.) |
![]() ![]() | IList::IndexOf | Determines the index of a specific item in the IList. (Inherited from Collection<T>.) |
![]() ![]() | IList::Insert | Inserts an item into the IList at the specified index. (Inherited from Collection<T>.) |
![]() ![]() | IList::IsFixedSize | Gets a value indicating whether the IList has a fixed size. (Inherited from Collection<T>.) |
![]() ![]() | IList::IsReadOnly | Gets a value indicating whether the IList is read-only. (Inherited from Collection<T>.) |
![]() ![]() | IList::Item | Gets or sets the element at the specified index. (Inherited from Collection<T>.) |
![]() ![]() | IList::Remove | Removes the first occurrence of a specific object from the IList. (Inherited from Collection<T>.) |
The MailMessage::To, MailMessage::CC, and MailMessage::Bcc properties return instances of this class that are used to hold the respective e-mail addresses.
For details on the mail address formats supported by the MailAddressCollection class, see the MailAddress class.
The following example adds an e-mail address to the MailAddressCollection that is returned by the Bcc property.
static void CreateBccTestMessage( String^ server ) { MailAddress^ from = gcnew MailAddress( L"ben@contoso.com",L"Ben Miller" ); MailAddress^ to = gcnew MailAddress( L"jane@contoso.com",L"Jane Clayton" ); MailMessage^ message = gcnew MailMessage( from,to ); message->Subject = L"Using the SmtpClient class."; message->Body = L"Using this feature, you can send an e-mail message from an application very easily."; MailAddress^ bcc = gcnew MailAddress( L"manager1@contoso.com" ); message->Bcc->Add( bcc ); SmtpClient^ client = gcnew SmtpClient( server ); client->Credentials = CredentialCache::DefaultNetworkCredentials; Console::WriteLine( L"Sending an e-mail message to {0} and {1}.", to->DisplayName, message->Bcc ); try { client->Send( message ); } catch ( Exception^ ex ) { Console::WriteLine(L"Exception caught in CreateBccTestMessage(): {0}", ex->ToString() ); } client->~SmtpClient(); }
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.






