在 C# 中使用 REST API 以 HTML 頁面形式查看 Word 文檔

作為 C# 開發人員，您可以在雲上的 .NET 應用程序中以編程方式輕鬆地將 DOC 或 DOCX 文件呈現為 HTML 頁面。它可用於與相關利益相關者共享您的 Word 文檔作為響應式 HTML 頁面。在本文中，您將學習如何在 C# 中使用 REST API 將 Word 文檔作為 HTML 頁面查看。

• Word 到 HTML 查看器 REST API 和 .NET SDK
• 在 C# 中使用 REST API 以 HTML 頁面形式查看 Word
• 使用 C# 使用呈現選項將 Word 呈現為 HTML 頁面
• 使用 C# 將帶有水印的 Word 呈現為 HTML

Word 到 HTML 查看器 REST API 和 .NET SDK

為了將 DOC 或 DOCX 文件呈現為 HTML，我將使用 GroupDocs.Viewer Cloud 的 .NET SDK API。它允許您以編程方式呈現和查看各種流行的文檔和圖像文件格式，例如 Word、Excel、PDF、PowerPoint, Visio、Project、Outlook、JPG、PNG 等。

您可以從 NuGet 包管理器將 GroupDocs.Viewer Cloud 安裝到您的 Visual Studio 項目中，或者在包管理器控制台中使用以下命令進行安裝：

Install-Package GroupDocs.Viewer-Cloud

在開始執行步驟和可用代碼示例之前，請從 儀表板 獲取您的客戶端 ID 和密碼。獲得客戶端 ID 和密碼後，添加如下所示的代碼：

string MyClientId = "112f0f38-9dae-42d5-b4fc-cc84ae644972";
string MyClientSecret = "16ad3fe0bdc39c910f57d2fd48a5d618";
string MyStorage = "";

var configuration = new Configuration(MyClientId, MyClientSecret);

在 C# 中使用 REST API 以 HTML 頁面形式查看 Word 文檔

您可以按照以下簡單步驟在雲端以 HTML 頁面形式查看 Word 文檔：

• 上傳DOCX文件到雲端
• 使用 C# 將 Word 渲染為 HTML
• 下載 呈現的 HTML 頁面

上傳文件

首先，使用下面給出的代碼示例將 DOCX 文件上傳到雲端：

// 初始化API
var apiInstance = new FileApi(configuration);

// 從本地/光盤打開 IOStream 中的文件。
var fileStream = File.Open(@"C:\Files\Sample.docx", FileMode.Open);

// 創建文件上傳請求
var request = new UploadFileRequest("sample.docx", fileStream, MyStorage);

// 上傳文件
var response = apiInstance.UploadFile(request);

因此，上傳的 DOCX 文件將在您的儀表板的 文件部分 中可用。

使用 C# 將 Word 呈現為 HTML 頁面

您可以按照以下步驟以編程方式將 Word 文檔呈現為 HTML 頁面：

• 創建 ViewAPI 的實例
• 創建 FileInfo 的實例
• 提供輸入文件路徑
• 創建 ViewOptions 的實例
• 將 FileInfo 分配給 ViewOptions
• 將 ViewFormat 設置為“HTML”
• 通過使用 ViewOptions 調用 CreateViewRequest 方法來創建視圖請求
• 通過使用 CreateViewRequest 調用 CreateView() 方法獲得響應

以下代碼示例展示瞭如何使用 C# 中的 REST API 將 Word 文檔呈現為 HTML 頁面。

// 初始化API
var apiInstance = new ViewApi(configuration);

// 輸入文件路徑
var fileInfo = new GroupDocs.Viewer.Cloud.Sdk.Model.FileInfo();
fileInfo.FilePath = "sample.docx";

// 定義視圖選項
var viewOptions = new ViewOptions();
viewOptions.FileInfo = fileInfo;
viewOptions.ViewFormat = ViewOptions.ViewFormatEnum.HTML;   // output view format

// 創建查看請求
var request = new CreateViewRequest(viewOptions);

// 創建視圖
var response = apiInstance.CreateView(request);

下載呈現的 HTML 頁面

上面的代碼示例會將呈現的 HTML 頁面保存在雲端。您可以使用以下代碼示例下載它們：

// 初始化API
var fileApi = new FileApi(configuration);

// 保存所有呈現的 HTML 頁面
foreach (var page in response.Pages)
{
    // 創建下載文件請求
    var downloadFileRequest = new DownloadFileRequest(page.Path, MyStorage);

    // 下載文件
    var file = fileApi.DownloadFile(downloadFileRequest);
    
    // 將文件保存在工作目錄中
    using (var fileStream = System.IO.File.Create("C:\\Files\\" + page.Path))
    {
        file.Seek(0, SeekOrigin.Begin);
        file.CopyTo(fileStream);
    }
}

使用 C# 使用呈現選項將 Word 呈現為 HTML 頁面

您可以按照以下給出的步驟，使用特定的呈現選項以編程方式將 Word 文檔呈現為 HTML 頁面：

• 創建 ViewAPI 的實例
• 創建 FileInfo 的實例
• 提供輸入文件路徑
• 創建 ViewOptions 的實例
• 將 FileInfo 分配給 ViewOptions
• 將 ViewFormat 設置為“HTML”
• 創建 RenderOptions 的實例
• 設置各種呈現選項，例如 PagesToRender、RenderComments 等。
• 通過使用 ViewOptions 調用 CreateViewRequest 方法來創建視圖請求
• 通過使用 CreateViewRequest 調用 CreateView() 方法獲得響應

以下代碼示例顯示如何使用 C# 中的 REST API 將 Word 文檔呈現為具有呈現選項的 HTML 頁面。

// 初始化API
var apiInstance = new ViewApi(configuration);

// 輸入文件路徑
var fileInfo = new GroupDocs.Viewer.Cloud.Sdk.Model.FileInfo();
fileInfo.FilePath = "sample.docx";

// 定義視圖選項
var viewOptions = new ViewOptions();
viewOptions.FileInfo = fileInfo;
viewOptions.ViewFormat = ViewOptions.ViewFormatEnum.HTML;   // output view format

// 定義渲染選項
viewOptions.RenderOptions = new RenderOptions
{
    // 呈現評論
    RenderComments = true,

    // 呈現特定範圍的頁面
    StartPageNumber = 1,
    CountPagesToRender = 2,
};

// 創建查看請求
var request = new CreateViewRequest(viewOptions);

// 創建視圖
var response = apiInstance.CreateView(request);

使用 C# 將帶有水印的 Word 呈現為 HTML

您可以按照以下步驟在以編程方式將 Word 文檔呈現為 HTML 時添加水印文本：

• 創建 ViewAPI 的實例
• 創建 FileInfo 的實例
• 提供輸入文件路徑
• 創建 ViewOptions 的實例
• 將 FileInfo 分配給 ViewOptions
• 將 ViewFormat 設置為“HTML”
• 定義水印視圖選項
• 設置水印文本、大小、顏色和位置
• 通過使用 ViewOptions 調用 CreateViewRequest 方法來創建視圖請求
• 通過使用 CreateViewRequest 調用 CreateView() 方法獲得響應

以下代碼示例顯示如何使用 C# 中的 REST API 將水印文本添加到呈現的 HTML 頁面。

// 初始化API
var apiInstance = new ViewApi(configuration);

// 輸入文件路徑
var fileInfo = new GroupDocs.Viewer.Cloud.Sdk.Model.FileInfo();
fileInfo.FilePath = "sample.docx";

// 定義視圖選項
var viewOptions = new ViewOptions();
viewOptions.FileInfo = fileInfo;
viewOptions.ViewFormat = ViewOptions.ViewFormatEnum.HTML;   // output view format

// 定義水印
viewOptions.Watermark = new Watermark
{
    Text = "This is a sample watermark!",
    Size = 100,
    Color = "Red",
    Position = Watermark.PositionEnum.Diagonal
};
          
// 創建查看請求
var request = new CreateViewRequest(viewOptions);

// 創建視圖
var response = apiInstance.CreateView(request);

在線試用

請試用以下使用上述API開發的免費在線Word渲染工具。 https://products.groupdocs.app/viewer/docx

結論

在本文中，您了解瞭如何在雲端以 HTML 頁面的形式查看 Word 文檔。您還學習瞭如何使用 C# 中的呈現選項將 Word 呈現為 HTML。此外，您還學習瞭如何使用 C# 以編程方式將文本水印添加到呈現的 HTML 頁面。此外，您還學習瞭如何以編程方式將 DOCX 文件上傳到雲端，然後從雲端下載呈現的 HTML 文件。您可以使用 文檔 了解有關 GroupDocs.Viewer Cloud API 的更多信息。我們還提供了一個 API 參考 部分，讓您可以直接通過瀏覽器可視化我們的 API 並與之交互。如有任何歧義，請隨時在論壇上與我們聯繫。

也可以看看

• GroupDocs.Viewer Cloud V2 版本