Installation

Make sure your machine meets the system requirements before you begin.

This article explains how to install Aspose.Words for .NET on your computer.

Install or Update Aspose.Words for .NET using Manage NuGet Packages

NuGet is the easiest way to download and install Aspose.Words for .NET APIs. To do this, follow these steps:

  1. Open Microsoft Visual Studio and Manage NuGet Packages from the menu to open package manager
  2. Search for “aspose” or “aspose.words” to find the desired Aspose API
    aspose-words-nuget
  3. Select the desired Aspose API and click “Install”

The selected API will be downloaded and referenced in your project.

You can also update Aspose.Words for .NET to the desired version using Manage NuGet Packages.

Install or Update Aspose.Words using Package Manager Console

You can also install or update Aspose.Words for .NET APIs using the Package Manager Console. To do this, follow these steps:

  1. Open Microsoft Visual Studio and Package Manager Console from the menu to open package manager console
    aspose-words-nuget-update
  2. Type the command Install-Package Aspose.Words and press Enter to install the latest full release into your application
    aspose-words-nuget-update-2
  3. Once downloaded, you will see confirmation messages
    aspose-words-nuget-istalled
  4. Now you may find that Aspose.Words has been successfully added and referenced in your application for you
    aspose-words-nuget-references

In Package Manager Console, you can also use the Update-Package Aspose.Words command to check for updates to the Aspose.Words package and install them if present. You can also add the -prerelease suffix to update the latest release.

Install Aspose.Words for .NET using Installer

Aspose.Words for .NET can be installed by direct downloading the MSI installer from the downloads section.

To Install Aspose.Words for .NET, follow these steps:

  1. Download Aspose.Words_{LatestVersion}.msi from the downloads section
  2. Doble-click the downloaded file, thereby starting the setup wizard, follow the setup wizard instructions
    aspose-words-setup-1
  3. When the setup wizard completes the installation, the required files will be available in the folder at the provided folder path
    aspose-words-setup-4
  4. Open your solution/project in Visual Studio
  5. Right-click your project in Solution Explorer and add the reference to installed assemblies
  6. Aspose.Words for .NET installed assemblies will appear in extensions under the Assemblies section – just select the required DLL component
    aspose-words-setup-5
  7. Finally, click OK

Considerations When Running in a Shared Server Environment

All Aspose .NET components are recommended to run with the Full Trust permission set. This is because Aspose .NET component sometimes needs access to registry settings and files located in places other than the virtual directory, such as reading fonts. 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 impose the following constraints, which may affect the ability of Aspose.Words to perform properly:

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

For these reasons specified above, it is recommended to run Aspose.Words with Full Trust permissions. You may find that some of library features will work when performing different tasks with Medium trust, and some will not, for example, rendering. This can be related to GDI+ image processing calls.