HTML 是用于在网络上呈现内容的首选格式,但在某些情况下,需要更可靠、更固定的文档格式。这时,将 HTML 转换为 XPS(XML 纸张规范)就变得至关重要。XPS 是一种标准化格式,可确保页面布局一致,非常适合创建需要精确格式的可打印文档、报告和档案。
.NET HTML 到 XPS 转换 API
GroupDocs.Conversion Cloud SDK for .NET 提供了一种将 HTML 文件转换为 XPS 格式的强大而高效的方法。使用此 SDK,将转换功能集成到您的 .NET 应用程序中非常简单,并且可以将 HTML 内容无缝转换为高质量的 XPS 文档。此方法的第一步是通过在 NuGet 包管理器中搜索 GroupDocs.Conversion-Cloud 并单击“安装”按钮来安装 SDK。另一个选项是在包管理器控制台中执行以下命令。
NuGet\Install-Package GroupDocs.Conversion-Cloud -Version 24.2.0
安装完成后,请获取您的个性化 API 凭证(即客户端 ID 和客户端密钥)。您可以访问这个简短的 教程,其中详细介绍了如何获取 API 凭证。
使用 C# .NET 将 HTML 转换为 XPS
本节详细介绍了如何通过使用 C# .NET 将 HTML 转换为 XPS 格式来生成固定布局报告或创建可打印的文档。
- 创建“配置”类的实例,我们将客户端凭据作为参数传递。
var configurations = new Configuration(clientId, clientSecret1);
- 初始化“ConvertApi”,我们将配置对象作为输入参数传递。
var apiInstance = new ConvertApi(configurations);
- 将输入的 HTML 文件上传到云存储。
fileUpload.UploadFile(new UploadFileRequest("sourceFile.html", stream));
- 创建一个实例“ConvertSettings”,其中我们在其中指定输入 HTML 的名称、结果格式为“xps”以及结果 XPS 文档的名称作为参数。
var settings = new ConvertSettings{...}
- 调用 ConvertDocumentRequest API 执行 HTML 到 XPS 的转换,并将生成的 XPS 文件保存到云存储。
var response = apiInstance.ConvertDocument(new ConvertDocumentRequest(settings));
// 更多示例请访问 https://github.com/groupdocs-conversion-cloud/groupdocs-conversion-cloud-dotnet
// 获取您的 API 凭证
string clientId = "XXXXXX-XXXXXXXXX-4088-9ca0-55c38f4b7f22";
string clientSecret1 = "XXXXXXXXXXXXXXXXXXXX";
// 创建配置类的实例,并使用客户端 ID 和客户端密钥对其进行初始化。
var configurations = new Configuration(clientId, clientSecret1);
// 定义 ApiBaseUrl 的值来设置 HTML 到 XPS 转换 API 的基本 URL。
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";
// 使用 Configuration 类的对象初始化 ConvertApi 类的实例。
var apiInstance = new ConvertApi(configurations);
// 从本地驱动器加载输入 HTML
using (var stream = System.IO.File.OpenRead("input.html"))
{
// 创建 FileApi 实例
var fileUpload = new FileApi(configurations);
// 将输入的 HTML 上传至云存储
fileUpload.UploadFile(new UploadFileRequest("input.html", stream));
// 创建 ConvertSettings,在其中定义源 HTML 的名称和生成的 XPS 文件的名称
var settings = new ConvertSettings
{
StorageName = "default",
FilePath = "input.html",
Format = "xps",
OutputPath = "resultant.xps"
};
// 调用 ConvertDocument 方法进行 HTML 到 XPS 的转换操作。
var response = apiInstance.ConvertDocument(new ConvertDocumentRequest(settings));
if (response != null && response.Equals("OK"))
{
// 打印成功信息
Console.WriteLine("The HTML to XPS conversion completed successfully !");
}
}
上述示例中生成的结果 XPS 文件可以从 resultantFile.xps 下载。
使用 cURL 命令将 HTML 转换为 XPS
如果您更喜欢命令行工具和自动化,使用 GroupDocs.Conversion Cloud 和 cURL 命令将 HTML 转换为 XPS 是一种灵活而高效的方法。此外,这种方法在需要自动化或批处理的场景中特别有用,非常适合将文档转换集成到脚本或服务器端工作流中的开发人员。
此方法的第一步是生成 JWT 访问令牌,然后执行以下 cURL 命令将网页转换为 XPS 文件。然后将生成的文件存储在云存储中。
curl -v "https://api.groupdocs.cloud/v2.0/conversion" \
-X POST \
-H "accept: application/json" \
-H "authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d "{ \"StorageName\": \"default\", \"FilePath\": \"{sourceFile}\", \"Format\": \"xps\",\"OutputPath\": \"{resultantFile}\"}"
请将“sourceFile”替换为输入 HTML 文件的名称,将“resultantFile”替换为结果 XPS 文件的名称,并将“accessToken”替换为个性化 JWT 访问令牌。
- 如果您要求将生成的 XPS 文件保存在本地驱动器上,请尝试使用以下 cURL 命令。
curl -v "https://api.groupdocs.cloud/v2.0/conversion" \
-X POST \
-H "accept: application/json" \
-H "authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d "{ \"StorageName\": \"default\", \"FilePath\": \"{sourceFile}\", \"Format\": \"xps\"}" \
-o "{resultantFile}"
免费 HTML 到 XPS 转换器
您可以考虑使用我们免费的 HTML 到 XPS 转换 应用程序探索 GroupDocs.Conversion Cloud REST API 的强大功能。这是一款轻量级且超高效的应用程序,可让您在 Web 浏览器中体验 API 的强大功能。
有用的链接
— 产品文档
-免费咨询
— 新发行
结论
将 HTML 转换为 XPS 对于创建适合打印、存档和跨平台共享的一致、高质量文档至关重要。无论您选择使用全面的 GroupDocs.Conversion Cloud SDK for .NET 还是轻量级 cURL 命令方法,这两种方法都提供了可靠且灵活的解决方案来实现此转换。我们鼓励您探索我们的 API 并利用其功能来简化您的文档转换需求并轻松提供专业的固定布局输出。
推荐文章
我们强烈建议您访问以下链接以了解更多信息: