Licensing and Limitations

Evaluate Aspose.Email

You can download Aspose.Email for .NET free of cost for evaluation. The evaluation version provides almost all functionality of the product with certain limitations. You can easily make the evaluation version licensed by adding a few lines of code to apply the license.

todo:image_alt_text

If you want to test Aspose.Email without evaluation version limitations, you can also request a 30 Day Temporary License. Please refer to How to get a Temporary License?

Evaluation Version Limitations

Evaluation version of Aspose.Email (without a license specified) provides full product functionality except some evaluation limitations.

License.txt file is added to the message file saved using Aspose.Email
Only 50 emails can be extracted from a folder in PST file
Only 3 attachments as well as inline images can be extracted from an MSG file
Max number of processed attacments in CFB format is 1
Max number of processed recipients in CFB format is 1
Adds “Evaluation Message” in Subject during saving in CFB,EML or MSG formats
End Date can’t be later then 31-12-2004 in GenerateOccurrences method of the recurrence pattern. This allows you to test the product meaningfully, yet impossible to use in a production application. For example, you can create a pattern such as “start on January 1, 2000 and repeat every last working day of a month” and generate occurrences for it. Occurrences after December 31, 2004 will not be generated in the evaluation mode
Adds “Evaluation Watermark Image” during saving in XPS or TIFF formats.
Max number of ambiguous e-mail addresses and display names resolved by MS Exchange Server is 20
Max length of data file allowed to be drag-and-dropped with FileDropPanel is 51200 bytes
Shows Message box with “Evaluation Message” during a drag-and-drop operation used by FileDropPanel
Only 1 file is extracted from given MSO stream by InlineAttachmentExtractor.EnumerateMsoPackage method

Applying a License

You can easily download an evaluation version of Aspose.Email from its download page. The evaluation version provides absolutely the same capabilities as the licensed version of Aspose.Email. Furthermore, evaluation version simply becomes licensed when you purchase a license and add a couple of lines of code to apply the license.

About the License

The license is a plain text XML file that contains details such as the product name, number of developers it is licensed to, subscription expiry date and so on. The file is digitally signed, so don’t modify the file. Even inadvertent addition of an extra line break into the file will invalidate it.

You need to set a license before utilizing Aspose.Email if you want to avoid its evaluation limitations. It is only required to set a license once per application (or process).

Apply License Using File or Stream Object

Setting a License in Aspose.Email for .NET

In Aspose.Email, license can be loaded from a file, stream or an embedded resource.Aspose.Email tries to find the license in the following locations:

Explicit path
The folder that contains the dll of the component (included in Aspose.Email)
The folder that contains the assembly that called the dll of the component (included in Aspose.Email)
The folder that contains the entry assembly (your .exe)
An embedded resource in the assembly that called the dll of the component (included in Aspose.Email) There are two common methods to set the license, which are discussed below:

Apply License using File or Stream Object

The easiest way to set a license, is to put the license file in the same folder as that of the dll of the component (included in Aspose.Email) and specify just the file name without its path.


 // Instantiate an instance of license and set the license file through its path

Aspose.Email.License license = new Aspose.Email.License();

license.SetLicense("Aspose.Email.lic");


 // Instantiate an instance of license and set the license through a stream

Aspose.Email.License license = new Aspose.Email.License();

license.SetLicense(myStream);

When you call SetLicense method, the license name should be same as that of your license file name. For example, you may change the license file name to “Aspose.Email.lic.xml”. Then in your code, you should use the modified license name (that is Aspose.Email.lic.xml) for the SetLicense method.

Apply Metered License

Aspose.Email allows developers to apply metered key. It is a new licensing mechanism. The new licensing mechanism will be used along with existing licensing method. Those customers who want to be billed based on the usage of the API features can use the metered licensing. For more details, please refer to Metered Licensing FAQ section.

A new class Metered has been introduced to apply metered key. Following is the sample code demonstrating how to set metered public and private keys.

	// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
	Aspose.Email.Metered metered = new Aspose.Email.Metered();
	// Access the SetMeteredKey property and pass public and private keys as parameters
	metered.SetMeteredKey("***", "***");

	// The path to the documents directory.
	string dataDir = RunExamples.GetDataDir_Email();

	// Load the document from disk.
	MailMessage eml = MailMessage.Load(dataDir + "Message.eml");
	//Get the page count of document
	Console.WriteLine(eml.Subject);

view raw Examples-CSharp-Licensing-ApplyMeteredLicense-ApplyMeteredLicense.cs hosted with ❤ by GitHub

Including the License File as an Embedded Resource

Another neat way of packaging the license with your application and making sure it will not be lost, is to include it as an embedded resource into one of the assemblies that calls the dll of the component (included in Aspose.Email). To include the license file as an embedded resource, perform the following steps:

In Visual Studio .NET, include the license (.lic) file into the project using the File | Add Existing Item… menu
Select the file in the Solution Explorer and set Build Action to Embedded Resource in the Properties window
To access the license embedded in the assembly (as embedded resource), it is not needed to call GetExecutingAssembly and GetManifestResourceStream methods of System.Reflection.Assembly class of Microsoft .NET Framework. All is needed to do, is to just add the license file as an embedded resource to your project and pass the name of the license file into SetLicense License method. The Licenseclass will automatically find the license file in the embedded resources.

Please review the example given below to understand this method of setting license (embedded) in your applications.


 // Instantiate the License class

Aspose.Email.License license = new Aspose.Email.License();

// Pass only the name of the license file embedded in the assembly

license.SetLicense("Aspose.Email.lic");

How to Check Version Number of Aspose.Email for .NET

Knowing the version number of the library that you are working with can be crucial for debugging, compatibility checks, and ensuring you are using the latest features and bug fixes. This guide will show you how to check the version number of Aspose.Email for .NET in various environments.

Using the API to Check Version Number

Aspose.Email for .NET provides a straightforward way to retrieve the version number programmatically. You can access this information through the BuildVersionInfo class.

The following C# code snippet to retrieve and display the version number:


using System;
using Aspose.Email;

class Program
{
    static void Main(string[] args)
    {
        // Get the version number of Aspose.Email for .NET
        string version = BuildVersionInfo.AssemblyVersion;
        
        // Display the version number
        Console.WriteLine("Aspose.Email for .NET Version: " + version);
    }
}

Checking Version Number in Visual Studio

You can also check the version number directly in Visual Studio without writing any code:

Solution Explorer:

Open your project in Visual Studio.
Navigate to the Solution Explorer.
Expand the “References” node under your project.

Reference Properties:

Locate “Aspose.Email” in the list of references.
Right-click on “Aspose.Email” and select “Properties”.
In the Properties window, you will see the version number listed under the “Version” property.

Using NuGet Package Manager

If you have installed Aspose.Email via NuGet, you can check the version number through the NuGet Package Manager:

Package Manager Console:

Open the Package Manager Console from Tools > NuGet Package Manager > Package Manager Console.
Enter the following command to list the installed packages:

Get-Package -Id Aspose.Email

This will display the version number of the Aspose.Email package installed in your project.

Manage NuGet Packages:

Right-click on your project in the Solution Explorer.
Select “Manage NuGet Packages”.
In the “Installed” tab, locate “Aspose.Email” to see the version number.

Checking Version Number in DLL Properties

You can also check the version number by examining the properties of the Aspose.Email DLL:

Locate the DLL:

Find the Aspose.Email DLL file in your project directory, typically under the bin folder.

View Properties:

Right-click on the Aspose.Email DLL file and select “Properties”.
Go to the “Details” tab. The version number will be displayed under the “Product version” or “File version” field.

By following any of these methods, you can easily check the version number of Aspose.Email for .NET, ensuring you have the correct version for your development needs. For further assistance and updates, refer to the Aspose.Email for .NET documentation.

Installation How to Run the Examples