使用取消令牌取消渲染

介绍

Groupdocs.Viewer for .NET 是一款功能强大的工具，旨在简化 .NET 应用程序中的文档查看和处理。无论您处理的是 PDF、Microsoft Office 文档还是其他常见格式，此库都能提供强大的功能，将文档查看功能无缝集成到您的 .NET 项目中。

先决条件

在深入研究 Groupdocs.Viewer for .NET 的集成之前，请确保您已满足以下先决条件：

安装：从提供的下载并安装 Groupdocs.Viewer for .NET 库下载链接.
许可证：从群组文档充分发挥图书馆的潜力。或者，您也可以使用临时执照.
开发环境：确保您已设置兼容的开发环境，包括 Visual Studio 或您选择的任何其他 .NET IDE。

导入命名空间

为了有效地利用 Groupdocs.Viewer for .NET，您需要将必要的命名空间导入到您的项目中。请按照以下步骤操作：

using System;
using System.IO;
using GroupDocs.Viewer.Options;
using System.Threading.Tasks;
using System.Threading;

现在，让我们将提供的示例分解为多个步骤，以便更好地理解和实施：

步骤 1：定义输出目录

string outputDirectory = "Your Document Directory";

此步骤设置存储渲染的文档页面的目录。

步骤2：定义页面文件路径格式

string pageFilePathFormat = Path.Combine(outputDirectory, "page_{0}.html");

在这里，我们定义各个文档页面的文件路径的格式。

步骤3：初始化CancellationTokenSource

CancellationTokenSource cancellationTokenSource = new CancellationTokenSource();

CancellationTokenSource 用于生成可用于取消异步操作的 CancellationToken 实例。

步骤4：获取CancellationToken

CancellationToken cancellationToken = cancellationTokenSource.Token;

此步骤从 CancellationTokenSource 中检索令牌，该令牌将用于取消渲染操作。

步骤5：渲染文档页面

Task.Run(() =>
{
    using (Viewer viewer = new Viewer(TestFiles.SAMPLE_DOCX, new ViewerSettings(new GroupDocs.Viewer.Logging.ConsoleLogger())))
    {
        HtmlViewOptions options = HtmlViewOptions.ForEmbeddedResources(pageFilePathFormat);
        options.RenderComments = true;
        viewer.View(options, cancellationToken);
    }
}, cancellationToken);

这里，我们使用 Task.Run() 异步启动文档页面的渲染。使用指定的文档文件 (SAMPLE_DOCX) 创建 Viewer 实例，并配置渲染选项。然后使用 Viewer 类的 View 方法启动渲染过程。

步骤 6：设置渲染超时

cancellationTokenSource.CancelAfter(10);

此步骤为渲染操作设置 10 毫秒的超时时间。如果操作超过此超时时间，则会自动取消。

步骤 7：显示成功消息

Console.WriteLine($"\nSource document rendered successfully.\nCheck output in {outputDirectory}.");

最后，显示一条成功消息，表明文档已成功呈现。

结论

在本教程中，我们介绍了将 Groupdocs.Viewer for .NET 集成到项目中的基础知识。按照上述步骤，您可以将文档查看功能无缝集成到 .NET 应用程序中，从而提升用户体验和工作效率。

常见问题解答

Groupdocs.Viewer for .NET 是否兼容所有文档格式？

Groupdocs.Viewer for .NET 支持多种文档格式，包括 PDF、Microsoft Office 文档、图像等。

我可以自定义呈现的文档页面的外观吗？

是的，您可以自定义渲染过程的各个方面，包括页面大小、质量、水印等。

Groupdocs.Viewer for .NET 是否需要互联网连接？

否，Groupdocs.Viewer for .NET 在您的 .NET 环境中本地运行，不需要互联网连接即可查看文档。

Groupdocs.Viewer for .NET 是否提供技术支持？

是的，可以通过以下方式获得技术支持 Groupdocs 论坛，您可以在此提问、报告问题并与社区互动。

我可以在购买之前试用 Groupdocs.Viewer for .NET 吗？

是的，你可以使用提供的免费试用版开始试用试用版.