MultipartEntity Class

Namespace:
GemBox.Email.Mime
Assembly:
GemBox.Email.dll

Represents MIME entity with multiple body parts.

public sealed class MultipartEntity : Entity, IList<Entity>, ICollection<Entity>, IEnumerable<Entity>, IEnumerable
Inheritance:
System.Object
MultipartEntity
Implements
System.Collections.Generic.IList<Entity>
System.Collections.Generic.ICollection<Entity>
System.Collections.Generic.IEnumerable<Entity>
System.Collections.IEnumerable

Constructors

MultipartEntity(String)

Initializes a new instance of the MultipartEntity class with specified media subtype.

public MultipartEntity(string mediaSubtype)
Parameters
mediaSubtype
System.String

The media subtype.

MultipartEntity(String, IEnumerable<Entity>)

Initializes a new instance of the MultipartEntity class with specified media subtype and collection of child entities.

public MultipartEntity(string mediaSubtype, IEnumerable<Entity> items)
Parameters
mediaSubtype
System.String

The media subtype.

items
System.Collections.Generic.IEnumerable<Entity>

The collection of child entities.

Exceptions
System.ArgumentNullException

Child collection is null.

System.ArgumentException

Child collection contains null elements.

Properties

Boundary

Gets or sets the boundary.

public string Boundary { get; set; }
Property Value
System.String

The boundary.

Exceptions
System.ArgumentException

Boundary is null or empty.

Count

Gets the count.

public int Count { get; }
Property Value
System.Int32

The count.

Epilogue

Gets or sets the entity epilogue.

public byte[] Epilogue { get; set; }
Property Value
System.Byte[]

The entity epilogue.

IsMultipart

Gets a value indicating whether this entity is multipart.

public override bool IsMultipart { get; }
Property Value
System.Boolean

True if this instance is multipart; otherwise, false.

Overrides

Item[Int32]

Gets or sets the Entity at the specified index.

public Entity this[int index] { get; set; }
Parameters
index
System.Int32

The index.

Property Value
Entity

The Entity.

Exceptions
System.ArgumentNullException

value

Preamble

Gets or sets the entity preamble.

public byte[] Preamble { get; set; }
Property Value
System.Byte[]

The entity preamble.

Methods

Add(Entity)

Adds the specified Entity item.

public void Add(Entity item)
Parameters
item
Entity

The Entity item.

Clear()

Removes all the items from this MultipartEntity.

public void Clear()

Clone()

Creates a copy of this MultipartEntity instance.

public override Entity Clone()
Returns
Entity

The copy of this MultipartEntity instance.

Overrides

Contains(Entity)

Determines whether this MultipartEntity contains the specified Entity item.

public bool Contains(Entity item)
Parameters
item
Entity

The Entity item.

Returns
System.Boolean

True if Entity item is found; otherwise, false.

CopyTo(Entity[], Int32)

Copies this MultipartEntity or a portion of it to an array.

public void CopyTo(Entity[] array, int arrayIndex)
Parameters
array
Entity[]

The one-dimensional Entity array that is the destination of the items copied from this MultipartEntity.

arrayIndex
System.Int32

The zero-based index in array at which copying begins.

Find(Func<Entity, Boolean>)

Checks if this MultipartEntity instance or one of its children satisfies a condition.

public override Entity Find(Func<Entity, bool> predicate)
Parameters
predicate
System.Func<Entity, System.Boolean>

A function to test each element for a condition.

Returns
Entity

MultipartEntity instance which satisfies a condition; otherwise, null.

Overrides

IndexOf(Entity)

Searches for the specified Entity item and returns the zero-based index of the first occurrence within this MultipartEntity.

public int IndexOf(Entity item)
Parameters
item
Entity

The Entity item.

Returns
System.Int32

The zero-based index of the first occurrence of Entity item within this MultipartEntity, if found; otherwise, –1.

Insert(Int32, Entity)

Inserts an Entity item at the specified index.

public void Insert(int index, Entity item)
Parameters
index
System.Int32

The index.

item
Entity

The Entity item.

Exceptions
System.ArgumentNullException

Entity item is null.

System.ArgumentException

Collection already contains Entity item.

Remove(Entity)

Removes the specified Entity item.

public bool Remove(Entity item)
Parameters
item
Entity

The Entity item.

Returns
System.Boolean

True if item is successfully removed; otherwise, false.

RemoveAt(Int32)

Removes the Entity item at the specified index.

public void RemoveAt(int index)
Parameters
index
System.Int32

The zero-based index of the Entity item to remove.

Inherited Properties

ContentType

Gets the Content-Type header value.

(Inherited from Entity)

Headers

Gets the Entity headers.

(Inherited from Entity)

Parent

Gets the Entity parent.

(Inherited from Entity)

Inherited Methods

Find(MediaType)

Checks if this Entity instance or one of its children matches the specified content type.

(Inherited from Entity)

Find(System.String)

Checks if this Entity instance or one of its children matches the specified top level media type.

(Inherited from Entity)

Implements

System.Collections.Generic.IList<T>
System.Collections.Generic.ICollection<T>
System.Collections.Generic.IEnumerable<T>
System.Collections.IEnumerable