Represents a collection of MapiAttachment objects. More...
Inherits System::Collections::Generic::ListExt< System::SharedPtr< Aspose::Email::Mapi::MapiAttachment > >.
Public Member Functions | |
MapiAttachmentCollection () | |
Initializes a new instance of the MapiAttachmentCollection class. More... | |
MapiAttachmentCollection (System::SharedPtr< MapiMessageItemBase > owner) | |
Initializes a new instance of the MapiAttachmentCollection class. More... | |
void | Add (System::String name, System::SharedPtr< MapiMessage > msg) |
Adds the new attachment as embedded message. More... | |
void | Add (System::String name, System::ArrayPtr< uint8_t > data) |
Adds the new attachment. More... | |
void | Add (System::String name, System::String sharedLink, System::String url, System::String providerName) |
Adds the reference attachment. More... | |
void | Add (const System::SharedPtr< MapiAttachment > &item) override |
Adds an object to the end of the T:System::Collections::ObjectModel::Collection`1. More... | |
void | Insert (int32_t index, const System::SharedPtr< MapiAttachment > &item) override |
Inserts an element into the T:System::Collections::ObjectModel::Collection`1 at the specified index. More... | |
void | Insert (int32_t index, System::String name, System::SharedPtr< MapiMessage > msg) |
Inserts a message as attachment into the MapiAttachmentCollection at the specified index. More... | |
void | Replace (int32_t index, System::String name, System::SharedPtr< MapiMessage > msg) |
Replaces an element at the specified index. More... | |
void | RemoveAt (int32_t index) override |
Removes the element at the specified index of the MapiAttachmentCollection. More... | |
bool | Remove (const System::SharedPtr< MapiAttachment > &item) override |
Removes the first occurrence of a specific object from the MapiAttachmentCollection. More... | |
System::String | GetNames () |
Gets the attachment names separated with comma. More... | |
bool | ContainsFileName (System::String fileName) |
Determines whether an element with defined name is in the collection. More... | |
System::SharedPtr< MapiAttachment > | CreateMapiAttachment (System::String name, System::SharedPtr< MapiMessage > msg, int32_t attachNum) |
void | DeepCopyTo (System::SharedPtr< MapiAttachmentCollection > dest) |
void | SetTemplateWeakPtr (uint32_t argument) override |
Protected Member Functions | |
virtual | ~MapiAttachmentCollection () |
Friends | |
class | Aspose::Email::Mapi::MapiMessage |
class | Aspose::Email::Tnef::TnefAttachment |
class | Aspose::Email::Tools::ForwardMessageBuilder |
Represents a collection of MapiAttachment objects.
Aspose::Email::Mapi::MapiAttachmentCollection::MapiAttachmentCollection | ( | ) |
Initializes a new instance of the MapiAttachmentCollection class.
Aspose::Email::Mapi::MapiAttachmentCollection::MapiAttachmentCollection | ( | System::SharedPtr< MapiMessageItemBase > | owner | ) |
Initializes a new instance of the MapiAttachmentCollection class.
owner | The owner message. |
|
protectedvirtual |
|
override |
Adds an object to the end of the T:System::Collections::ObjectModel::Collection`1.
item | The object to be added to the end of the T:System::Collections::ObjectModel::Collection`1. The value can be null for reference types. |
void Aspose::Email::Mapi::MapiAttachmentCollection::Add | ( | System::String | name, |
System::ArrayPtr< uint8_t > | data | ||
) |
Adds the new attachment.
name | The name of attachment. |
data | The attachment data. |
ArgumentNullException | throws if attachment name is null or empty. |
ArgumentNullException | throws if attachment data is null. |
void Aspose::Email::Mapi::MapiAttachmentCollection::Add | ( | System::String | name, |
System::SharedPtr< MapiMessage > | msg | ||
) |
Adds the new attachment as embedded message.
name | The name of attachment. |
msg | The MapiMessage that represents the attached message. |
ArgumentNullException | throws if message is null. |
void Aspose::Email::Mapi::MapiAttachmentCollection::Add | ( | System::String | name, |
System::String | sharedLink, | ||
System::String | url, | ||
System::String | providerName | ||
) |
Adds the reference attachment.
A reference attachment is a type of attachment that includes a link or a reference to a file or item, rather than including the file or item itself in the email message. When the recipients of the email click on the reference attachment, they will be able to access the linked file if they have the appropriate permissions to do so. By using a reference attachment, you can send a smaller email message and ensure that everyone has access to the most up-to-date version of the file or item.
name | The name of attachment. |
sharedLink | A fully qualified shared link to the attachment provided by web service manipulating the attachment. |
url | A file location. |
providerName | A name of reference attachment provider. |
ArgumentNullException | throws if attachment name is null or empty. |
ArgumentNullException | throws if attachment shared link is null or empty. |
This example demonstrates how to add a reference attachment to a message.
[C#]
[Visual Basic]
bool Aspose::Email::Mapi::MapiAttachmentCollection::ContainsFileName | ( | System::String | fileName | ) |
Determines whether an element with defined name is in the collection.
fileName |
System::SharedPtr<MapiAttachment> Aspose::Email::Mapi::MapiAttachmentCollection::CreateMapiAttachment | ( | System::String | name, |
System::SharedPtr< MapiMessage > | msg, | ||
int32_t | attachNum | ||
) |
void Aspose::Email::Mapi::MapiAttachmentCollection::DeepCopyTo | ( | System::SharedPtr< MapiAttachmentCollection > | dest | ) |
System::String Aspose::Email::Mapi::MapiAttachmentCollection::GetNames | ( | ) |
Gets the attachment names separated with comma.
|
override |
Inserts an element into the T:System::Collections::ObjectModel::Collection`1 at the specified index.
index | The zero-based index at which item should be inserted. |
item | The object to insert. The value can be null for reference types. |
T:System::ArgumentOutOfRangeException | index is less than zero. |
-or-
index is greater than P:System::Collections::ObjectModel::Collection`1::Count.
void Aspose::Email::Mapi::MapiAttachmentCollection::Insert | ( | int32_t | index, |
System::String | name, | ||
System::SharedPtr< MapiMessage > | msg | ||
) |
Inserts a message as attachment into the MapiAttachmentCollection at the specified index.
index | The zero-based index at which should be inserted. |
name | The name of attachment. |
msg | The MapiMessage that represents the attached message. |
ArgumentNullException | throws if message is null. |
|
override |
Removes the first occurrence of a specific object from the MapiAttachmentCollection.
item | The object to remove from the MapiAttachmentCollection. |
|
override |
Removes the element at the specified index of the MapiAttachmentCollection.
index | he zero-based index of the element to remove. |
void Aspose::Email::Mapi::MapiAttachmentCollection::Replace | ( | int32_t | index, |
System::String | name, | ||
System::SharedPtr< MapiMessage > | msg | ||
) |
Replaces an element at the specified index.
index | The zero-based index at which should be replaced. |
name | The name of attachment. |
msg | The MapiMessage that represents the attached message. |
ArgumentNullException | throws if message is null. |
|
override |
|
friend |
|
friend |
|
friend |