Aspose.Email 24.11.0

Effortless Email Management API

Aspose.Email for .NET is a comprehensive email management API designed for developers working with Microsoft Outlook® items, MIME messages, email clients, and various protocols including SMTP, POP3, IMAP, Exchange, and Microsoft Graph. It facilitates sending and receiving emails, managing appointments, contacts, and attachments, as well as converting email files between different formats. With support for platforms such as Gmail, Zimbra, Thunderbird, and IBM Notes, Aspose.Email for .NET enables developers to create interactive AMP HTML emails, handle advanced email validation, and read Outlook storage files like PST, OST, and OLM. Whether working with cloud-based email services or handling on-premises email storage, Aspose.Email provides an efficient and flexible solution for managing email data in .NET applications.

Send Email Messages via MailGun and SendGrid

• Send email messages using MailGun or SendGrid services.
• Use DeliveryServiceOptions to configure service-specific settings.
• Code sample to send an email synchronously and asynchronously.
• Error handling for unsuccessful email deliveries.

Working with MIME Messages

• Create and set email contents in .NET.
• Work with attachments and embedded objects.
• Extract contents from MIME messages.
• Load and save messages using MailMessage.
• Track document conversion progress and render hyperlinks with custom styles.

Working with Appointments

• Create appointments and save them as .msg or .ics.
• Create appointments with HTML content.
• Load appointments in ICS format.
• Convert appointments to MailMessage or MapiMessage.
• Read multiple events from an ICS file.
• Write multiple events to an ICS file.
• Determine the appointment version using Appointment.Version.

Working with Outlook Items

• Create and save MSG files.
• Load, view, and parse MSG files.
• Manage message files using Aspose.Email.Outlook.
• Work with voting options, follow-up flags, and due dates.
• Manage attachments, contacts, tasks, notes, calendar items, distribution lists, and recurrences.

Working with Outlook Storage Files

• Create PST files and add subfolders/messages.
• Read and convert OST files.
• Work with messages, contacts, distribution lists, calendar items, MapiTasks, MapiJournal, and MapiNote in PST.
• Split and merge PST files.
• Password protect PST files.
• Read corrupted PST/OST files and convert OLM to PST.

Working with SMTP Client

• Send emails synchronously or asynchronously using SmtpClient.
• Perform mail merge and row-wise mail merge.
• Use multiconnection mode to send multiple messages concurrently.
• Send messages in TNEF format to preserve email formatting.
• Send meeting requests via email.

Working with POP3 Client

• Delete emails by index or delete all emails using Pop3Client.
• Cancel deletion of messages using Pop3Client.UndeleteMessages.
• Validate mail server credentials using ValidateCredentials method.

Working with IMAP Client

• Support for IMAP IDLE command to wait for new email.
• List server extensions such as IDLE, UNSELECT, and QUOTA.
• Fetch messages and list attachments.
• Validate mail server credentials.
• Log IMAP activity for debugging.

Working with Exchange EWS Client

• Send meeting requests using EWSClient.
• Create, update, and cancel appointments.
• List appointments with paging support.
• Add events to secondary calendar folders.
• Share calendar invitations via Exchange server.

Programming with Gmail

• Create, list, delete, fetch, and update Google Calendars.
• Manage calendar access control rules (list, create, update, delete).
• Retrieve client settings and color info.
• Work with appointments: add, retrieve, update, move, and delete.

Programming with Thunderbird

• Write messages to Thunderbird storage using MboxrdStorageWriter.
• Delete emails using MboxClient.

Convert Email Files using C# API

• Convert .eml to different formats using Aspose.Email.
• Load .eml files and convert them into MailMessage.
• Convert appointments to MailMessage or MapiMessage.

Working with Zimbra

• Read Zimbra TGZ storage files using TgzReader.
• Get total items count from a TGZ file.
• Save messages with directory structure.
• Export calendar and contact items from Zimbra backup files.

Email Verification with Aspose.Email

Validate email addresses, domains, and mail servers using Aspose.Email.Verifications. Supports syntax-only validation, domain validation, and mail server connection validation using EmailValidator.

AMP HTML Email Creation

Create interactive AMP HTML emails using AmpMessage with components like AmpImage, AmpCarousel, AmpAccordion, AmpForm, and more for enhanced user interaction.

Adding AMP Components

Use classes such as AmpImage, AmpCarousel, AmpForm, AmpFitText, and AmpAccordion to embed various interactive elements in AMP emails.

Detect NSF File Format

Detect if a file is in NSF format using FileFormatUtil.DetectFileFormat().

Read Messages from NSF File

Use NotesStorageFacility to read messages from an NSF storage file with the EnumerateMessages method. Note: Reading folders is not supported.

Supported File Formats

Supported Operating Systems

Windows

Windows Server (2003, 2008, 2012), XP, Vista, 7, 8, 8.1, 10, Windows Azure

Linux

Ubuntu, openSUSE, CentOS, and others

Mac

macOS

Supported Frameworks

.NET Frameworks

2.0 - 4.7.2, .NET Standard 2.0, .NET Core (2.0, 2.1)

Mono Framework

Mono 5.4+

Xamarin

Xamarin.Android, Xamarin.iOS, Xamarin.Mac

Development Environments

Microsoft Visual Studio

2010, 2011, 2012, 2013, 2015, 2017, 2019

Installation Steps for Aspose.Email for .NET

1. Install via NuGet

• Open Visual Studio → NuGet Package Manager.
• Search "aspose" and click "Install" for Aspose.Email.

2. Install or Update via Package Manager Console

• Open Package Manager Console (Tools → Library Package Manager → Package Manager Console).
• To install:
  Install-Package Aspose.Email -Version x.x.0
• To update:
  Update-Package Aspose.Email

3. Reference Aspose.Email in Your Project

• In Solution Explorer, right-click References → Add Reference.
• Locate Aspose.Email.dll and add it.

4. Uninstall Aspose.Email for .NET

• Go to Control Panel → Add/Remove Programs.
• Select Aspose.Email and click Remove.

5. Target Specific .NET Framework Version

• Modify the configuration file (.config) to redirect references if targeting .NET 1.0 instead of 1.1.

Convert MSG File to EML and Preserve RTF Content

This code demonstrates how to load a MSG file, convert it to EML format, and preserve RTF content.

   var loadOptions = new MsgLoadOptions
   {
       PreserveRtfContent = true
   };

   var eml = MailMessage.Load("my.msg", loadOptions);

   var conversionOptions = new MailConversionOptions
   {
       PreserveRtfContent = true
   };

   var msg = MapiMessage.Load("my.msg");
   var eml = msg.ToMailMessage(conversionOptions);

Retrieve Messages Asynchronously using ImapClient

This code demonstrates how to retrieve messages asynchronously from an IMAP server using Aspose.Email.

   List<MailMessage> mailMessages = new List<MailMessage>();

   // create mail messages
   for (int i = 0; i < 100; i++)
       mailMessages.Add(new MailMessage(senderEmail, receiverEmail, $"Message #{i}", "Text"));

   using (ImapClient client = new ImapClient(host, 993, senderEmail, password, SecurityOptions.SSLImplicit))
   {
       CancellationTokenSource cancellationTokenSource = new CancellationTokenSource();
       AutoResetEvent autoResetEvent = new AutoResetEvent(false);
       Exception exception = null;

       ThreadPool.QueueUserWorkItem(delegate
       {
           try
           {
               // start uploading the messages
               var task = client.AppendMessagesAsync(mailMessages, cancellationTokenSource.Token);
               AppendMessagesResult appendMessagesResult = task.GetAwaiter().GetResult();
               Console.WriteLine("All messages have been appended.");
           }
           catch (Exception ex)
           {
               exception = ex;
           }
           finally
           {
               autoResetEvent.Set();
           }
       });

       autoResetEvent.WaitOne();
   }

Extract Email Attachments

This code snippet shows how to extract attachments from an email message, save them, and print the attachment names.

   var eml = MailMessage.Load("Message.eml", new MsgLoadOptions());

   foreach (var attachment in eml.Attachments)
   {
       attachment.Save("MessageEmbedded_out.eml");
       Console.WriteLine(attachment.Name);
   }

Tags

Email Management API | .NET Email API | MIME Messages | Outlook Integration | SMTP Protocol | POP3 Protocol | IMAP Protocol | Exchange EWS | Microsoft Graph | Gmail API | Thunderbird Email | Email Conversion | Zimbra Integration | AMP HTML Email | IBM Notes | Email Validation | Email Attachments | Outlook PST | OST File | EML Conversion | Apple Mail | ICS Format | Contact Management | Calendar Events | Xamarin Support | Linux Compatible | macOS Support | HTML Format