Getting Started

系统要求

GcExcel .NET 包完全支持适用于 Windows 的 Visual Studio 2017 或更高版本、适用于 MAC 的 Visual Studio 以及适用于 Linux 的 Visual Studio Code，并且与以下系统兼容：

• .NET（5 及更高版本）——包括所有当前和未来的长期支持（LTS）和短期支持（STS）版本

• .NET Core 2.x 和 3.x

• .NET Standard 2.x

• .NET Framework 4.6.1 或更高版本

依赖项

下表列出了 GcExcel .NET 中使用的开源库：

应用程序设置

GcExcel .NET 引用可通过 NuGet 获得，NuGet 是一个 Visual Studio 扩展，可自动将库和引用添加到项目中。要使用 GcExcel .NET，应用程序中需要有以下引用：

在应用程序中添加对 GcExcel .NET 的引用

要在 .NET Core、ASP.NET Core、.NET Framework 应用程序（任何支持 .NET Standard 2.0 的目标）中使用 GcExcel .NET，请使用以下步骤在应用程序中安装 NuGet 包：

Windows 版 Visual Studio

查找并安装 GrapeCity.Documents.Excel NuGet 包：

1. 在“解决方案资源管理器”中，右键单击“依赖项”或项目，然后选择“管理 NuGet 包”。

2. 在“浏览”选项卡中，从“包源”下拉菜单中选择“nuget.org”。

3. 在“浏览”选项卡中，在顶部的搜索文本框中输入“grapecity.documents”或“GrapeCity.Documents”，找到“GrapeCity.Documents.Excel”包，如下图所示。

   
   

   
   

4. 单击“安装”，将“GrapeCity.Documents.Excel”包及其依赖项安装到项目中。安装完成后，确保在解决方案资源管理器中检查 NuGet 文件夹，并确认 GrapeCity.Documents.Excel 包是否已添加到项目依赖项中。

   
   

   
   

手动创建 NuGet 包源

要手动创建 NuGet 源，需要完成以下步骤，将 NuGet 源 URL 添加到 Visual Studio 中的 NuGet 设置中。在执行此步骤之前，请确保首先下载 GcExcel .NET 并将其放在本地文件夹中，例如“D:\Nupkg”。

1. 从“工具”菜单中，选择“NuGet 包管理器 | 包管理器设置”。此时将出现“选项”对话框。

2. 在左窗格中，选择“包源”。

3. 单击右上角的按钮。在“可用包源”下将添加一个新源。

4. 为新的包源设置一个“名称”。

5. 要在“源”字段中添加源，请单击“源”字段旁边的省略号按钮，浏览到“Nupkg”文件夹。

6. 选择“Nupkg”文件夹后，单击“更新”按钮，最后单击“确定”。

使用命令行界面安装 GrapeCity.Documents.Excel 包

1. 在 Windows 系统上打开命令提示符窗口。

2. 使用以下命令创建一个控制台应用程序“myApp”：dotnet new console -o myApp

3. 使用“cd”命令导航到项目文件夹：cd myApp

4. 使用以下命令安装 GcExcel .NET NuGet 包：dotnet add package GrapeCity.Documents.Excel

添加 GrapeCity.Documents.Excel 包引用

GcExcel .NET 是一个跨平台电子表格组件，可在包括 Windows、Linux 和 Mac 操作系统在内的多个平台上使用。

如果使用 Visual Studio 创建应用程序，用户可以编辑 .csproj 文件并添加包引用，如下图所示：

完成此步骤后，请遵循快速入门部分中的步骤。

Mac 版 Visual Studio

1. 打开 Mac 版 Visual Studio。

2. 创建任何应用程序（任何支持 .NET Standard 2.0 的目标）。

3. 在左侧的树视图中，右键单击“依赖项”并选择“添加包”。

4. 在“搜索”面板中，输入“GrapeCity.Documents”。

5. 从左侧面板中显示的包列表中，选择“GrapeCity.Documents.Excel”并单击“添加包”。

6. 单击“接受”。

   这将自动将包及其依赖项的引用添加到应用程序中。完成此步骤后，请遵循快速入门部分中的步骤。

Linux 版 Visual Studio

1. 打开 Visual Studio Code。

2. 从“扩展”中安装“NuGet 包管理器”。

3. 在“主目录”中创建一个名为“MyApp”的文件夹。

4. 在 Visual Studio Code 的终端中，输入“cd MyApp”。

5. 输入命令“dotnet new console”。注意：这将创建一个带有 MyApp.csproj 文件和 Program.cs 的 .NET Core 应用程序。

6. 按 Ctrl+P。顶部将打开一个命令行。

7. 输入命令：“>”。注意：出现“NuGet 包管理器：添加包”选项。

8. 单击上述选项。

9. 输入“Grapecity”并按回车键。注意：GrapeCity 包将显示在下拉列表中。

10. 选择“GrapeCity.Documents.Excel”。

11. 在终端窗口中输入以下命令：“dotnet restore”。

    这会将包的引用添加到应用程序中。完成此步骤后，请遵循快速入门部分中的步骤。