GcDocs for PDF | 快速开始

本教程将以 "Hello, World!" 文本为例，为您演示如何使用 GcPDF 生成和保存 PDF 文件。

GcDocs.PDF 组件是基于 .NET Standard 2.0构建的，并且可以与任何支持它的引用程序一起使用。在本简短的教程中，我们将展示如何构建.NET Core Console应用程序。本教程将会使用到 Windows 或者 Mac 上的 Visual Studio 或者 Linux 上的 Visual Studio Code。

创建一个空控制台应用程序

使用 Windows 上的 Visual Studio

打开 Visual Studio。
创建一个 .NET Core 控制台应用程序
在 Solution Explorer 中右键单击项目文件，并选择Manage NuGet Packages.
在 Package source 中选择 nuget.org.
单击左上角的 Browse 标签，搜索 "GcDocs"。您将看到 GcDocs 系列组件.
选择GcDocs.PDF，点击安装。并接受许可协议。

这样会将所需的依赖添加至您项目的依赖中. 现在您可以跳转到添加代码来了解如何在应用程序中生成 PDF 文件。

使用 MAC 上的 Visual Studio

打开 Visual Studio。
创建一个 .NET Core 控制台应用程序
在左侧的树形视图中，右键点击 Dependencies 并且选择 Add Packages。
在 Search 面板中, 输入 "GcDocs".
从左面板的列表中, 选择 GcDocs.PDF 并且点击 Add Packages。
接受许可协议。

这样会将所需的依赖添加至您项目的依赖中. 现在您可以跳转到添加代码来了解如何在应用程序中生成 PDF 文件。

使用 Linux 上的 Visual Studio Code

在一个 Terminal 窗口中 (您也可以使用 Visual Studio Code 中的 Terminal 窗口)，输入以下命令：

$ mkdir ~/MyApp # 给应用程序创建目录
$ cd ~/MyApp
$ dotnet new console # 创建一个 .NET Core 应用程序，其中包含 MyApp.csproj 和 Program.cs 文件

打开 Visual Studio Code。
从 Extensions 安装 Nuget Package Manager，并且激活它。
在 Visual Studio Code 中，使用 Ctrl+P 打开文件命令框, 输入 > ，从下拉列表中找到 "Nuget Package Manager: Add Package"。
在打开的搜索框中，输入 "GcDocs"，并按 Enter 确认。这样会列出可用的 GcDocs 组件包，其中应该包含 GcDocs.PDF
选择它，这样即可在 .csproj 文件中添加依赖, 他现在看起来像这样：

<Project Sdk="Microsoft.NET.Sdk">
    <PropertyGroup>
        <OutputType>Exe</OutputType>
        <TargetFramework>net8.0</TargetFramework>
    </PropertyGroup>
    <ItemGroup>
        <PackageReference Include="DS.Documents.Pdf" Version="7.0.0" />
    </ItemGroup>
</Project>

在 Terminal 窗口中, 输入一下命令 build 应用程序，并运行：

$ cd ~/MyApp
$ dotnet restore # 恢复 MyApp.csproj 中的依赖包
$ dotnet run # 运行应用程序

这时候，您将在 Terminal 窗口中看到 "Hello, World!" (这是新建应用程序的默认逻辑)。现在，修改应用程序，来生成 PDF 文件。

添加代码

在 Visual Studio 或者 Visual Studio Code 中打开 Program.cs 并且修改它，代码如下：

using System;
using System.Drawing;
using GrapeCity.Documents.Pdf;
using GrapeCity.Documents.Text;

namespace MyApp
{
    class Program
    {
        static void Main(string[] args)
        {
            // 创建 PDF 文档:
            GcPdfDocument doc = new GcPdfDocument();
            // 添加一个页面，并获取 Graphics 对象:
            GcPdfGraphics g = doc.NewPage().Graphics;
            // 向页面中渲染一个文本:
            g.DrawString("Hello, World!",
                // 使用标准字体 (GcPDF 中内置 14 种标准字体，可以一直使用):
                new TextFormat() { Font = StandardFonts.Times, FontSize = 12 },
                // GcPDF 页面坐标默认从左上角开始计算，DPI 默认为 72:
                new PointF(72, 72));
            // 保存 PDF 文件:
            doc.Save("HelloWorld.pdf");
        }
    }
}

现在运行程序:

在 Windows 或者 MAC, 只需要在 Visual Studio 中点击 "start debugging"。
在 Linux, 在 Terminal 窗口中输入下面的代码：

$ cd ~/MyApp
$ dotnet run # 运行 MyApp

这就是使用 GcPDF 生成PDF文件所需的全部. 您将在工程目录下看到 HelloWorld.pdf 文件。

与 Hello, World! 的原理相同，你还可以有以下选择：

以上是本教程的所有内容，有关更多信息，请参阅 API 页面和文档.