[]
        
(Showing Draft Content)

Getting Started

System Requirements

The GcWord packages are fully supported on Visual Studio 2017 or later for Windows, Visual Studio for MAC, and Visual Studio Code for Linux and are compatible with the following:

  • .NET 5, .NET 6, and .NET 7

  • .NET Core 2.x and 3.x

  • .NET Standard 2.x

  • .NET Framework 4.6.1 or higher

Setting up an Application

GcWord references are available through NuGet, a Visual Studio extension that adds the required libraries and references to your project automatically. To work with GcWord, you need to have following references in your application:

Reference

Purpose

GcDocs.Word

To use GcWord in an application, you need to reference (install) just the GrapeCity.Documents.Word package. It pulls in the required infrastructure packages.

GcDocs.Word.Layout

To enable saving Word documents to PDF, install the GrapeCity.Documents.Layout package (GcLayout for short). It provides extension methods allowing to save GcWordDocument as PDF.

GcDocs.Imaging

For image handling, you need to reference (install) the GrapeCity.Documents.Imaging package.

GcDocs.Imaging.Windows

On a Windows system, you can optionally install GrapeCity.Documents.Common.Windows. It provides support for font linking specified in the Windows registry, and access to native Windows imaging APIs, improving performance and adding some features (e.g. TIFF support).

GcDocs.DX.Windows

GrapeCity.Documents.DX.Windows is an infrastructure package used by GrapeCity.Documents.Common.Windows. You do not need to reference it directly.

Add reference to GcWord in your application from nuget.org

In order to use GcWord in a .NET Core, ASP.NET Core, .NET Framework application (any target that supports .NET Standard 2.0), install the NuGet packages in your application using the following steps:

Visual Studio for Windows

  1. Open Visual Studio.

  2. Create any application (any target that supports .NET Standard 2.0).

  3. Right-click the project in Solution Explorer and choose Manage NuGet Packages.

  4. In the Package source on top right, select nuget.org.

  5. Click Browse tab on top left and search for "GcDocs".

  6. On the left panel, select GcDocs.Word

  7. On the right panel, click Install.

     image

  8. In the Preview Changes dialog, click OK and choose I Accept in the next screen.

Visual Studio for Mac

  1. Open Visual Studio for Mac.

  2. Create any application (any target that supports .NET Standard 2.0).

  3. In tree view on the left, right-click Dependencies and choose Add Packages.

  4. In the Search panel, type "GcDocs".

  5. From the list of packages displayed in the left panel, select GcDocs.Word and click Add Packages.

  6. Click Accept.

This automatically adds references of the package and its dependencies to your application.

Visual Studio Code for Linux

  1. Open Visual Studio Code.

  2. Install Nuget Package Manager from Extensions.

  3. Create a folder "MyApp" in your Home folder.

  4. In the Terminal in Visual Studio Code, type "cd MyApp"

  5. Type command "dotnet new console"Observe: This creates a .NETCore application with MyApp.csproj file and Program.cs.

  6. Press Ctrl+P. A command line opens at the top.

  7. Type command: ">"Observe: "Nuget Package Manager: Add Package" option appears.

  8. Click the above option.

  9. Type "GcDocs" and press Enter.Observe: GrapeCity packages get displayed in the dropdown.

  10. Choose GcDocs.Word.

  11. Type following command in the Terminal window: "dotnet restore"

This adds references of the package to your application.