InternetAddressList Class

A list of email addresses.

Inheritance Hierarchy

SystemObject
MimeKitInternetAddressList

Namespace: MimeKit
Assembly: MimeKit (in MimeKit.dll) Version: 4.7.1

Syntax

Copy

public class InternetAddressList : IList<InternetAddress>, 
	ICollection<InternetAddress>, IEnumerable<InternetAddress>, IEnumerable, 
	IEquatable<InternetAddressList>, IComparable<InternetAddressList>

The InternetAddressList type exposes the following members.

Constructors

	Name	Description
	InternetAddressList	Initialize a new instance of the InternetAddressList class.
	InternetAddressList(IEnumerableInternetAddress)	Initialize a new instance of the InternetAddressList class.

Top

Properties

	Name	Description
	Count	Get the number of addresses in the InternetAddressList.
	IsReadOnly	Get a value indicating whether the InternetAddressList is read only.
	Item	Get or set the InternetAddress at the specified index.
	Mailboxes	Recursively get all of the mailboxes contained within the InternetAddressList.

Top

Methods

	Name	Description
	Add	Add an address to the InternetAddressList.
	AddRange	Add a collection of addresses to the InternetAddressList.
	Clear	Clear the address list.
	CompareTo	Compare two internet address lists.
	Contains	Check if the InternetAddressList contains the specified address.
	CopyTo	Copy all of the addresses in the InternetAddressList to the specified array.
	Equals(InternetAddressList)	Determine whether the specified InternetAddressList is equal to the current InternetAddressList.
	Equals(Object)	Determine whether the specified object is equal to the current object. (Overrides ObjectEquals(Object))
	Finalize	(Inherited from Object)
	GetEnumerator	Get an enumerator for the list of addresses.
	GetHashCode	Return the hash code for this instance. (Overrides ObjectGetHashCode)
	GetType	(Inherited from Object)
	IndexOf	Get the index of the specified address.
	Insert	Insert an address at the specified index.
	MemberwiseClone	(Inherited from Object)
	Parse(Byte)	Parse the given input buffer into a new InternetAddressList instance.
	Parse(String)	Parse the given text into a new InternetAddressList instance.
	Parse(Byte, Int32)	Parse the given input buffer into a new InternetAddressList instance.
	Parse(ParserOptions, Byte)	Parse the given input buffer into a new InternetAddressList instance.
	Parse(ParserOptions, String)	Parse the given text into a new InternetAddressList instance.
	Parse(Byte, Int32, Int32)	Parse the given input buffer into a new InternetAddressList instance.
	Parse(ParserOptions, Byte, Int32)	Parse the given input buffer into a new InternetAddressList instance.
	Parse(ParserOptions, Byte, Int32, Int32)	Parse the given input buffer into a new InternetAddressList instance.
	Remove	Remove the specified address from the InternetAddressList.
	RemoveAt	Remove the address at the specified index.
	ToString	Serialize an InternetAddressList to a string suitable for display. (Overrides ObjectToString)
	ToString(Boolean)	Serialize an InternetAddressList to a string, optionally encoding the list of addresses for transport.
	ToString(FormatOptions, Boolean)	Serialize an InternetAddressList to a string, optionally encoding the list of addresses for transport.
	TryParse(Byte, InternetAddressList)	Try to parse the given input buffer into a new InternetAddressList instance.
	TryParse(String, InternetAddressList)	Try to parse the given text into a new InternetAddressList instance.
	TryParse(Byte, Int32, InternetAddressList)	Try to parse the given input buffer into a new InternetAddressList instance.
	TryParse(ParserOptions, Byte, InternetAddressList)	Try to parse the given input buffer into a new InternetAddressList instance.
	TryParse(ParserOptions, String, InternetAddressList)	Try to parse the given text into a new InternetAddressList instance.
	TryParse(Byte, Int32, Int32, InternetAddressList)	Try to parse the given input buffer into a new InternetAddressList instance.
	TryParse(ParserOptions, Byte, Int32, InternetAddressList)	Try to parse the given input buffer into a new InternetAddressList instance.
	TryParse(ParserOptions, Byte, Int32, Int32, InternetAddressList)	Try to parse the given input buffer into a new InternetAddressList instance.

Top

Operators

	Name	Description
	(InternetAddressList to MailAddressCollection)	Explicit cast to convert a InternetAddressList to a MailAddressCollection.
	(MailAddressCollection to InternetAddressList)	Explicit cast to convert a MailAddressCollection to a InternetAddressList.

Top

Remarks

An InternetAddressList may contain any number of addresses of any type defined by the original Internet Message specification.

There are effectively two (2) types of addresses: mailboxes and groups.

Mailbox addresses are what are most commonly known as email addresses and are represented by the MailboxAddress class.

Group addresses are themselves lists of addresses and are represented by the GroupAddress class. While rare, it is still important to handle these types of addresses. They typically only contain mailbox addresses, but may also contain other group addresses.

Reference

MimeKit Namespace