Installing Aspose.Words 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.
Install or Update Aspose.Words using the Package Manager Console
You can follow the steps below to reference the Aspose.Words API using the package manager console:
- Open your solution/project in Visual Studio.
- Select Tools -> Library Package Manager -> Package Manager Console from the menu to open package manager console.
Type the command “Install-Package Aspose.Words” 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.
You will see that the "Downloading Aspose.Words..." tip appears down the bottom left of the window indicating that the download is process.
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.
You should now find that Aspose.Words has successfully been added and referenced in your application for you.
In the package manager console, you can also use the command “Update-Package Aspose.Words” and press enter to check for any updates to the Aspose.Words 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.Words is 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.
Aspose.Words for .NET does not need Microsoft Word installed, as Aspose.Words itself is a Microsoft Word document creation, conversion, page layout and rendering engine.
Aspose.Words for .NET supports any 32-bit or 64-bit operating system where .NET or Mono framework is installed including, but not limited to:
- Microsoft Windows desktop (XP, Vista, 7, 8, 10) and server operating systems (2003, 2008, 2012)
- Windows Azure
- Linux (Ubuntu, openSUSE, CentOS and others)
- Mac OS X
Aspose.Words for .NET supports .NET and Mono frameworks as follows:
- .NET Framework versions 2.0 or later including Client Profile versions
- Mono 2.6.7 or later
You can use Aspose.Words for .NET to develop applications in any development environment that targets the .NET platform, but the following environments are explicitly supported:
- Microsoft Visual Studio 2010 and later
- MonoDevelop 2.4 and later