什么是 DWG 文件？

DWG 是 AutoCAD 用来存储二维和三维设计数据的原生二进制格式。它包含矢量几何、图层、文本以及描述工程图纸、平面图、机械部件等技术示意图的元数据。由于该格式为专有格式，大多数通用图像查看器无法解释其几何信息；需要专用的 CAD 解析器。

为什么 .NET 开发者需要在 Web 门户中渲染 DWG

如果你的解决方案是以文档为中心的门户——无论是 DMS、CRM、工程门户还是法律科技案件查看器——你都会不可避免地收到来自建筑师、机械工程师或承包商的 DWG 文件。用户期望能够即时预览这些文件，而无需下载笨重的桌面 CAD 程序。提供浏览器内预览可以消除摩擦，降低支持工单数量，并将工作流保持在安全的应用边界内。

将 DWG 转换为 PDF 以应对回退场景

并非所有客户端都能直接渲染矢量 CAD（例如旧版浏览器或屏幕阅读器）。将 DWG 转换为 PDF 可以提供一种通用的可视化方式，同时保留线条和图层可见性。

Doconut 的 Converter Plugin 可以在服务器端完成此转换：

• 不需要 Microsoft Office 或 AutoCAD 安装。
• 转换在你的 .NET 进程或 Docker 容器中运行，数据始终受你控制。
• 输出的 PDF 可以缓存并在后续查看时复用，降低 CPU 负载。

典型流程：

1. 使用 DWG 文件的路径（或流）调用转换器。
2. 接收一个 PDF 文件（以路径或流的形式）。
3. 将 PDF 与原始 DWG 一起存储，以便快速查找。

在 .NET 前端直接显示 DWG

当你需要完整的 CAD 体验——缩放、平移、图层切换——请使用 Doconut 的 Universal Document Viewer。该查看器原生支持 DWG 文件，在服务器上解析矢量数据，并将图像瓦片流式传输到浏览器。客户端收到的 HTML/JavaScript 会在 canvas 中渲染这些瓦片，提供流畅、无需 Office 的体验。

集成要点：

• 在 ASP.NET Core 管道中注册查看器中间件（例如 app.UseDoconut(...)）。
• 中间件会自动处理瓦片请求，无需额外的路由代码。
• 由于查看器支持流式输入，你可以直接从前面创建的临时存储中读取文件。

最终，你可以得到一个可嵌入的 <iframe>，或一个现成的 React/Angular/Vue 组件，在网页中显示带有交互式缩放、平移和图层控制的 DWG。

综合实现：端到端的 DWG 预览工作流

1. 上传 – 用户将 DWG 文件拖拽到门户中。
2. 验证并存储 – 服务器检查文件并保存。
3. 可选转换 – 如需 PDF 回退，调用 Converter Plugin 并缓存 PDF。
4. 渲染 – 使用 Doconut SDK 打开 DWG 文档并获取查看器令牌。随后查看器中间件向前端提供所需瓦片。
5. 交互 – 用户可以缩放、平移、切换图层。如点击 “Download PDF”，则从第 3 步缓存的 PDF 中提供下载。

所有这些步骤都在你的 .NET 6/8 应用内部完成，无需任何外部 CAD 二进制、Office 安装或第三方服务。

将 Doconut NuGet 包添加到你的解决方案，配置查看器中间件，然后尝试上传一份从 AutoCAD 导出的示例 DWG。你会看到文件在浏览器中瞬间渲染，并且只需一行代码即可为偏好静态视图的用户生成 PDF。此集成满足需求，让你能够直接向利益相关者展示 DWG 内容。