Installation

Installing Aspose.Imaging for .NET through NuGet

NuGet is the easiest way to download and install Aspose APIs for .NET. Open Microsoft Visual Studio and NuGet package manager. Search “aspose” to find the desired Aspose API. Click on “Install”, the selected API will be downloaded and referenced in your project.

todo:image_alt_text

Install or Update Aspose.Imaging using the Package Manager Console

You can follow the steps below to reference the Aspose.Imaging API using the package manager console:

  1. Open your solution/project in Visual Studio.
  2. Select Tools -> Library Package Manager -> Package Manager Console from the menu to open package manager console.

todo:image_alt_text

Type the command “Install-Package Aspose.Imaging” and press enter to install latest full release into your application. Alternatively you can add the “-prerelease” suffix to the command in order to specify that the latest release including hot fixes is to be installed as well.

todo:image_alt_text

You will see that the “Installing Aspose.Imaging” tip appears down the bottom of the window indicating that the download is process. 

todo:image_alt_text

Once downloaded you will see the following confirmation messages. If you are not familiar with the Aspose EULA then it is a good idea to read the license referenced in the URL. 

todo:image_alt_text

You should now find that Aspose.Imaging has successfully been added and referenced in your application for you.

todo:image_alt_text

In the package manager console, you can also use the command “Update-Package Aspose.Imaging” and press enter to check for any updates to the Aspose.Imgaing package and install them if present. You can also add the “-prerelease” suffix to update latest release.

Considerations When Running on a Shared Server Environment

All Aspose .NET components are recommended to run with Full Trust permission set. This is because Aspose .NET component sometimes need to access registry settings and files located in places other than the virtual directory e.g. for reading fonts etc. Furthermore, Aspose.NET components are based on core .NET system classes, some of which also require Full Trust permission to run in some cases.

Internet Service Providers hosting multiple applications from different companies mostly enforce Medium Trust security level. In the case of .NET 2.0, such a security level may set the following constraints which could affect the ability of Aspose.Words to perform properly.

  • RegistryPermission is not available. This means you cannot access the registry, which is required to enumerate installed fonts when rendering documents.
  • FileIOPermission is restricted. This means you can only access files in your application’s virtual directory hierarchy. This potentially means fonts cannot be read during export.

For these reasons specified above, it is recommended that Aspose.Imaging to run on Full Trust permissions. You may find that some features of library will work when performing different tasks in Medium trust while some won’t (rendering for example) which may due to calls to GDI+ image processing.

Working with .NET Core DLLs installed via MSI package

Please note: if you use NetStandard dll installed via MSI package you should add necessary dependencies to work with netStandard version (please see release notes for more information).

Working with Aspose.Imaging .NET Core dlls in Non-Windows Environment

Aspose.Imaging is cross-platform library that supports not only Windows OS, but also other operation systems. More information about how to work with Aspose.Imaging .NET Core dlls in Non-Windows Environment.