EmailAddressCollection Class |
Namespace: MailBee.Mime
The EmailAddressCollection type exposes the following members.
Name | Description | |
---|---|---|
EmailAddressCollection | Initializes a new instance of the EmailAddressCollection class | |
EmailAddressCollection(String) |
Initializes a new EmailAddressCollection instance from a string containing e-mail addresses.
|
Name | Description | |
---|---|---|
Add(String) |
Adds the specified e-mail address to the collection.
| |
Add(EmailAddress) |
Adds the specified EmailAddress object to the collection.
| |
Add(EmailAddressCollection) |
Adds the list of the e-mail addresses specified as EmailAddressCollection to the current collection.
| |
Add(String, String) |
Adds the e-mail address (specified as actual e-mail address and display name parts) to the collection.
| |
Add(String, String, String) |
Adds the e-mail address (specified as actual e-mail address, display name and remarks parts) to the collection.
| |
AddFromString |
Adds the specified full e-mail addresses (including display name if any) to the collection.
| |
Clear |
Clears the entire collection of the e-mail addresses.
| |
Equals | 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.) | |
FromIdnAddress |
Gets a new EmailAddress object which is a copy of the current object with the domain part of each e-mail address converted from IDN format.
| |
GetEnumerator | Returns an enumerator that iterates through the CollectionBase instance. (Inherited from CollectionBase.) | |
GetHashCode | Serves as the default hash function. (Inherited from Object.) | |
GetType | Gets the Type of the current instance. (Inherited from Object.) | |
MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) | |
OnClear | Performs additional custom processes when clearing the contents of the CollectionBase instance. (Inherited from CollectionBase.) | |
OnClearComplete | Performs additional custom processes after clearing the contents of the CollectionBase instance. (Inherited from CollectionBase.) | |
OnInsert | Performs additional custom processes before inserting a new element into the CollectionBase instance. (Inherited from CollectionBase.) | |
OnInsertComplete | Performs additional custom processes after inserting a new element into the CollectionBase instance. (Inherited from CollectionBase.) | |
OnRemove | Performs additional custom processes when removing an element from the CollectionBase instance. (Inherited from CollectionBase.) | |
OnRemoveComplete | Performs additional custom processes after removing an element from the CollectionBase instance. (Inherited from CollectionBase.) | |
OnSet | Performs additional custom processes before setting a value in the CollectionBase instance. (Inherited from CollectionBase.) | |
OnSetComplete | Performs additional custom processes after setting a value in the CollectionBase instance. (Inherited from CollectionBase.) | |
OnValidate | Performs additional custom processes when validating a value. (Inherited from CollectionBase.) | |
Parse |
Creates a new EmailAddressCollection instance from the specified string containing the list of e-mail addresses.
| |
Remove |
Removes the specified e-mail address from the collection.
| |
RemoveAt |
Removes the EmailAddress object having the the specified zero-based index from the collection.
| |
ToIdnAddress |
Gets a new EmailAddressCollection object which is a copy of the current object with the domain part of each e-mail address converted into IDN format.
| |
ToString |
Returns the string containing all the e-mail addresses in the collection.
(Overrides ObjectToString.) |
Name | Description | |
---|---|---|
(EmailAddressCollection to String) |
Defines an implicit conversion of an e-mail address collection into a string.
|
Name | Description | |
---|---|---|
AsString |
Gets or sets all the e-mail addresses in the collection as a string.
| |
Capacity | Gets or sets the number of elements that the CollectionBase can contain. (Inherited from CollectionBase.) | |
Count | Gets the number of elements contained in the CollectionBase instance. This property cannot be overridden. (Inherited from CollectionBase.) | |
InnerList | Gets an ArrayList containing the list of elements in the CollectionBase instance. (Inherited from CollectionBase.) | |
Item |
Gets the EmailAddress object at the specified zero-based index in the collection.
| |
List | Gets an IList containing the list of elements in the CollectionBase instance. (Inherited from CollectionBase.) |
In the most cases, the developer does not need to directly create an EmailAddress to specify e-mail addresses because the most methods and properties which deal with e-mail addresses also accept string inputs as e-mail address values.
EmailAddressCollection class offers AsString property for this. For instance, to specify MailMessage.To as a string, set msg.To.AsString value (assuming msg is MailMessage instance).
If you need to deal with international e-mail addresses (IDN domains), use FromIdnAddress and ToIdnAddress methods to convert e-mail addresses between human-readable and SMTP-safe formats.
// To use the code below, import MailBee namespaces at the top of your code. using MailBee; using MailBee.Mime; // The actual code (put it into a method of your class) // Load the message from file. MailMessage msg = new MailMessage(); msg.LoadMessage(@"C:\Docs\TestMail.eml"); // For every recipient... foreach (EmailAddress adr in msg.To) { // Show full information about the recipient's e-mail address. Console.WriteLine("Recipient name: " + adr.DisplayName); Console.WriteLine("Recipient address: " + adr.Email); Console.WriteLine("Recipient info: " + adr.Remarks); Console.WriteLine("Account name: " + adr.GetAccountName()); Console.WriteLine("Domain name: " + adr.GetDomain()); }