在 C# 中使用 REST API 向 Word 文檔添加水印

您可以通過編程方式將文本或圖像作為水印添加到雲端的 Word 文檔中。水印用於識別文檔的創建者或其他信息，如版權或徽標等。通常，水印以疊加圖像、徽標、圖案或放置在文檔內部的文本的形式使用。在本文中，您將了解如何使用 C# 中的 REST API 向 Word 文檔添加水印。

本文應涵蓋以下主題：

• 水印 REST API 和 .NET SDK
• 在 C# 中使用 REST API 將文本水印添加到 Word 文檔
• 使用 REST API 將圖像水印添加到 Word 文檔

水印 REST API 和 .NET SDK

為了向 DOCX 文件添加文本或圖像水印，我將使用 GroupDocs.Watermark Cloud 的 .NET SDK API。它允許您以編程方式添加、刪除、搜索和替換受支持文件格式(如 PDF、Microsoft Word 和 Powerpoint)的圖像和文檔中的水印。此外，您可以根據需要指定文本樣式、字體、大小、顏色或位置來控制水印的自定義。目前，它還為 Cloud API 提供了 Java SDK。

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

Install-Package GroupDocs.Watermark-Cloud

在執行上述步驟之前，請從 dashboard 獲取您的 Client ID 和 Secret。獲得 ID 和密碼後，添加如下所示的代碼：

string clientId = "da0c487d-c1c0-45ae-b7bf-43eaf53c5ad5";
string clientSecret = "479db2b01dcb93a3d4d20efb16dea971";
string myStorage = "";

var configuration = new Configuration(clientId, clientSecret);
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";

在 C# 中使用 REST API 將文本水印添加到 Word 文檔

您可以通過以下簡單步驟以編程方式將任何文本作為水印添加到您的 Word 文檔中：

• 上傳 the DOCX file to the Cloud
• 使用C#為DOCX添加文本水印
• 下載 the watermarked file

上傳文件

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

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

// 打開文件
var fileStream = File.Open(@"C:\Files\sample.docx", FileMode.Open);

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

// 上傳文件
fileApi.UploadFile(request);
fileStream.Close();

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

使用 C# 將文本水印添加到 DOCX

您可以按照下面給出的步驟以編程方式將文本水印添加到 DOCX 文件。

• 創建 WatermarkApi 的實例
• 創建 FileInfo 的實例
• 設置DOCX文件路徑
• 創建 WatermarkOptions 並設置 FileInfo
• 創建 TextWatermarkOptions
• 設置文本、字體系列、字體大小和文本對齊方式
• 設置水印文本的前景色
• 定義水印位置
• 定義 WatermarkDetails 並設置 TextWatermarkOptions 和 Position
• 使用 WatermarkOptions 創建 AddRequest
• 調用WatermarkApi.add()方法獲取結果

以下代碼示例顯示如何使用 C# 中的 REST API 將文本作為水印添加到 Word 文檔。

// 初始化接口
var apiInstance = new WatermarkApi(configuration);

// 輸入文件路徑
var fileInfo = new FileInfo
{
    FilePath = "sample.docx"
};

// 創建水印選項
var options = new WatermarkOptions()
{
    FileInfo = fileInfo,
    
    // 定義水印細節
    WatermarkDetails = new List<WatermarkDetails>
    {
        new WatermarkDetails
        {
            // 定義文本水印
            TextWatermarkOptions = new TextWatermarkOptions
            {
                Text = "Copyright© 2021",
                FontFamilyName = "Arial",
                FontSize = 22d,
                TextAlignment = "Center",
                ForegroundColor = new Color()
                {
                    Name = "Red"
                }
            },

            // 設置水印位置
            Position = new Position()
            {
                X = 230.0,
                Y = 500.0
            }
        }
    }
};

// 創建添加請求
var request = new AddRequest(options);

// 加水印
var response = apiInstance.Add(request);

Console.WriteLine("Resultant file path: " + response.DownloadUrl);

下載更新文件

上面的代碼示例將帶有文本水印的Word文件保存在雲端。您可以使用以下代碼示例下載它：

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

// 雲上的默認文件路徑
var file = "watermark/added_watermark/sample_docx/sample.docx";

// 創建下載文件請求
var downloadRequest = new DownloadFileRequest(file, myStorage);

// 下載文件
Stream downloadResponse = fileApi.DownloadFile(downloadRequest);

// 將文件保存在工作目錄中
using (var fileStream = System.IO.File.Create("C:\\Files\\DownloadedFile.docx"))
{
    downloadResponse.Seek(0, SeekOrigin.Begin);
    downloadResponse.CopyTo(fileStream);
}

使用 REST API 將圖像水印添加到 Word 文檔

您可以按照以下步驟以編程方式將圖像或徽標作為水印添加到您的 Word 文檔中。

• 創建 WatermarkApi 的實例
• 創建 FileInfo 的實例
• 設置DOCX文件路徑
• 創建 WatermarkOptions 並設置 FileInfo
• 創建 ImageWatermarkOptions
• 將 PNG 圖像的文件路徑設置為水印
• 定義水印位置
• 創建水印詳情
• 設置 ImageWatermarkOptions 和位置
• 將 WatermarkDetails 設置為列表
• 使用 WatermarkOptions 創建 AddRequest
• 調用WatermarkApi.add()方法獲取結果

以下代碼示例展示瞭如何使用 C# 中的 REST API 將圖像作為水印添加到 DOCX。請按照前面提到的步驟上傳和下載文件。

// 初始化接口
var apiInstance = new WatermarkApi(configuration);

// 輸入文件路徑
var fileInfo = new FileInfo
{
    FilePath = "sample.docx"
};

// 創建水印選項
var options = new WatermarkOptions()
{
    FileInfo = fileInfo,
    // 定義水印細節
    WatermarkDetails = new List<WatermarkDetails>
    {
        new WatermarkDetails
        {
            // 定義圖像水印
            ImageWatermarkOptions = new ImageWatermarkOptions()
            {
                Image = new FileInfo { 
                    FilePath = "logo.png" 
                }
            },

            // 設置水印位置
            Position = new Position()
            {
                X = 180.0,
                Y = 280.0
            }
        }
    }
};

// 創建添加請求
var request = new AddRequest(options);

// 加水印
var response = apiInstance.Add(request);

Console.WriteLine("Resultant file path: " + response.DownloadUrl);

在線試用

請嘗試以下使用上述 API 開發的免費在線水印工具。 https://products.groupdocs.app/watermark/docx

結論

總而言之，您已經了解瞭如何為雲端的 Word 文檔添加文本或圖像水印。您還學習瞭如何以編程方式將 DOCX 文件上傳到雲端，然後從雲端下載更新後的文件。您可以從 文檔 了解有關 GroupDocs.Watermark Cloud API 的更多信息。我們還提供了一個 API 參考 部分，讓您可以直接通過瀏覽器可視化我們的 API 並與之交互。如有任何疑問，請隨時聯繫 支持。

也可以看看

• 使用 REST API 查找和替換文檔中的水印
• 用於保護文檔的 Watermark Cloud API 和 SDK