使用 GroupDocs.Conversion 在 .NET 中将 XLSM 转换为 XLSX：分步指南

介绍

将 XLSM 文件转换为广泛使用的 XLSX 格式对企业和开发者来说可能颇具挑战性。本教程提供了使用 GroupDocs.Conversion for .NET 的分步指南，简化了应用程序中的文件转换流程。

您将学到什么：

  • 在 .NET 环境中设置 GroupDocs.Conversion。
  • 将 XLSM 文件转换为 XLSX 的分步指南。
  • 关键配置选项和故障排除提示。
  • 此功能的实际应用。

先决条件

开始之前，请确保您已准备好以下内容：

所需的库、版本和依赖项

  • GroupDocs.Conversion for .NET：文件转换需要版本 25.3.0。

环境设置要求

  • 安装了 .NET Framework 或 .NET Core 的开发环境。
  • Visual Studio 或支持 .NET 应用程序的兼容 IDE。

知识前提

  • 对 C# 编程和 .NET 中的文件处理有基本的了解。
  • 熟悉使用 NuGet 管理包。

为 .NET 设置 GroupDocs.Conversion

安装 GroupDocs.Conversion 库以开始：

NuGet 包管理器控制台：

Install-Package GroupDocs.Conversion -Version 25.3.0

.NET CLI：

dotnet add package GroupDocs.Conversion --version 25.3.0

许可证获取步骤

先免费试用，或申请临时许可证以使用完整功能。如需商业用途，请购买许可证。

基本初始化和设置

在 C# 中初始化转换过程：

using System;
using System.IO;
using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;

class Program
{
    static void Main(string[] args)
    {
        string documentPath = Path.Combine(@"YOUR_DOCUMENT_DIRECTORY", "example.xlsm");
        
        using (Converter converter = new Converter(documentPath))
        {
            var convertOptions = new SpreadsheetConvertOptions();
            
            // 指定输出格式为 XLSX
            convertOptions.Format = GroupDocs.Conversion.FileTypes.SpreadsheetFileType.Xlsx;
            
            string outputPath = Path.Combine(@"YOUR_OUTPUT_DIRECTORY", "converted.xlsx");
            converter.Convert(outputPath, convertOptions);
        }
    }
}

此代码初始化一个 Converter 对象并将其配置为将 XLSM 文件转换为 XLSX 格式。替换 "YOUR_DOCUMENT_DIRECTORY" 和 "YOUR_OUTPUT_DIRECTORY" 使用系统上的实际路径。

实施指南

功能：加载XLSM并将其转换为XLSX

此功能允许您加载 XLSM 文件并将其转换为 XLSX，并在必要时保留所有数据（包括宏）。请按以下步骤操作：

步骤 1：设置文件路径

定义文件的输入和输出路径。

string documentPath = Path.Combine(@"YOUR_DOCUMENT_DIRECTORY", "example.xlsm");
string outputPath = Path.Combine(@"YOUR_OUTPUT_DIRECTORY", "converted.xlsx");

步骤 2：初始化转换器

创建一个 Converter 使用 XLSM 文件路径的实例。

using (Converter converter = new Converter(documentPath))
{
    // 转换步骤将在此处添加
}

步骤 3：配置转换选项

设置 SpreadsheetConvertOptions 将输出格式指定为 XLSX。

var convertOptions = new SpreadsheetConvertOptions();
convertOptions.Format = GroupDocs.Conversion.FileTypes.SpreadsheetFileType.Xlsx;

步骤4：执行转换

使用 Convert 方法，传递您的输出路径和转换选项。

converter.Convert(outputPath, convertOptions);

故障排除提示

  • 文件访问问题：确保文件路径正确且可访问。如有必要，请检查目录权限。
  • 转换错误：验证 GroupDocs.Conversion 库是否在您的项目中正确安装和引用。

实际应用

将 XLSM 转换为 XLSX 在以下情况下可能会很有用：

  1. 数据迁移：确保从遗留系统迁移数据时具有更好的互操作性。
  2. 宏观保存：保留宏功能，以便在商业应用中更广泛地使用。
  3. 合作：促进不同平台和系统之间更轻松地共享文件。

性能考虑

为了优化性能：

  • 处置 Converter 对象以释放资源。
  • 实现多文件转换的批处理技术。
  • 根据您的速度质量需求调整转换选项。

结论

您已经学习了如何使用 GroupDocs.Conversion for .NET 将 XLSM 文件转换为 XLSX 文件。此功能对于增强各种业务场景中的数据互操作性和工作流效率至关重要。您可以考虑探索该库的其他功能，或将此解决方案集成到更大的系统中，以实现自动化批处理。

准备好尝试了吗？实现此转换过程可以显著简化 .NET 应用程序中的文件处理任务。祝您编码愉快！

常见问题解答部分

  1. 将 XLSM 转换为 XLSX 的主要好处是什么？
    • 增强了不同 Excel 版本和平台之间的兼容性和更广泛的支持。
  2. 从 XLSM 转换为 XLSX 时可以保留宏吗？
    • 是的，GroupDocs.Conversion 在转换期间保留了宏功能。
  3. 使用 GroupDocs.Conversion 是否需要付费？
    • 可以免费试用；如需商业使用，请购买许可证或申请临时许可证。
  4. 如何处理应用程序中的文件路径？
    • 使用 Path.Combine 构建独立于操作系统的可靠文件路径。
  5. 如果在转换过程中遇到错误该怎么办？
    • 检查常见问题，例如文件路径不正确或缺少库引用，并查阅文档以获取故障排除提示。

资源