Document Solutions for Word
In This Topic
    Getting Started
    In This Topic

    System Requirements

    The DsWord 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:

    Setting up an Application

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

    Reference Purpose
    DS.Documents.Word To use DsWord in an application, you need to reference (install) just the DS.Documents.Word package. It pulls in the required infrastructure packages.
    DS.Documents.Word.Layout To enable saving Word documents to PDF, install the DS.Documents.Word.Layout package (DsWordLayout for short). It provides extension methods allowing to save DsWordDocument as PDF.
    DS.Documents.Imaging For image handling, you need to reference (install) the DS.Documents.Imaging package.
    DS.Documents.DX.Windows DS.Documents.DX.Windows is an infrastructure package. You do not need to reference it directly.

    Note: With v7.0, GrapeCity.Documents.Word (GcWord) package is renamed to DS.Documents.Word (DsWord). The namespaces and classes within DS.Documents.Word remain the same, which provide the same functionality and are backwards compatible with GrapeCity.Documents.Word, ensuring minimal impact on your existing projects.

    To upgrade GcWord package to DsWord package in your existing projects, follow one of the below options:

    • Update package using Migration tool:
      1. The migration tool is present in the package downloaded from the website. Follow the instructions displayed in the UI when using the tool for a seamless migration from GcWord to DsWord.
    • Update package manually from NuGet package manager:
      1. In Solution Explorer, right-click either Dependencies or a project and select Manage NuGet Packages.
      2. In Installed tab, click on GrapeCity.Documents.Word package and click Uninstall to remove it and its dependencies from the project.
      3. In Browse tab, type "ds.documents" or "DS.Documents" in the search text box at the top and find the package "DS.Documents.Word".
      4. Click Install to add the DS.Documents.Word package and its dependencies into the project.

    Add reference to DsWord in your application from nuget.org

    In order to use DsWord 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:

    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 "DS.Documents".
    6. On the left panel, select DS.Documents.Word.
    7. On the right panel, click Install.
    8. In the Preview Changes dialog, click OK and choose I Accept in the next screen.
    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 "DS.Documents".
    5. From the list of packages displayed in the left panel, select DS.Documents.Word and click Add Packages.
    6. Click Accept.

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

    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 "DS" and press Enter.
      Observe: DS packages get displayed in the dropdown.
    10. Choose DS.Documents.Word.
    11. Type following command in the Terminal window: "dotnet restore"

    This adds references of the package to your application.