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:
- Open Microsoft Visual Studio and Manage NuGet Packages from the menu to open package manager
- Search for “aspose” or “aspose.words” to find the desired Aspose API
- 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:
- Open Microsoft Visual Studio and Package Manager Console from the menu to open package manager console
- Type the command
Install-Package Aspose.Words
and press Enter to install the latest full release into your application
In addition, you can add the-prerelease
suffix to the command to specify that the latest release, including hotfixes, should also be installed. - Once downloaded, you will see confirmation messages
If you are unfamiliar with the Aspose EULA, it is recommended to read the license referenced in the URL. - Now you may find that Aspose.Words has been successfully added and referenced in your application for you
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:
- Download
Aspose.Words_{LatestVersion}.msi
from the downloads section - Doble-click the downloaded file, thereby starting the setup wizard, follow the setup wizard instructions
- When the setup wizard completes the installation, the required files will be available in the folder at the provided folder path
- Open your solution/project in Visual Studio
- Right-click your project in Solution Explorer and add the reference to installed assemblies
- Aspose.Words for .NET installed assemblies will appear in extensions under the Assemblies section – just select the required DLL component
- 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.