向 PDF 文件添加水印是保护您的文档免受未经授权使用和建立品牌身份的最有效方法之一。 使用 .NET Cloud SDK,您可以轻松地向 PDF 文档添加文本水印、应用印章,并通过简单的 .NET REST API 以编程方式自定义水印的外观。
为什么在 PDF 文档中添加水印?
水印在 PDF 文档中有多个目的,包括:
- 品牌:在每一页上添加公司徽标或名称作为可见标记。
- 版权保护:防止内容被滥用或剽窃。
- 保密性:在文件上标记如
保密”或草稿”的标签。 - 专业演示:可通过签名、日期或项目名称进行自定义。
PDF 水印 REST API for .NET
GroupDocs.Watermark Cloud SDK for .NET 提供了一个 REST API,用于在 PDF、Word、PPTX、Excel 和图像文件中添加、编辑和管理水印。水印确保您的文件保持受保护和视觉一致。
关键特性
- 将文本或图像水印插入 PDF 文件。
- 在所有页面或选择的页面上应用水印。
- 调整透明度、字体、旋转和对齐。
- 移除或更新文档中的现有水印。
安装
通过 NuGet 安装 SDK:
Install-Package GroupDocs.Watermark-Cloud
在 C# 中为 PDF 添加文本水印
按照以下步骤使用 C# .NET 向 PDF 文档添加文本水印。
步骤 1. – 初始化 API。
var configuration = new Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
var watermarkApi = new WatermarkApi(configuration);
步骤 2. – 指定输入 PDF 文件的名称。
var fileInfo = new FileInfo
{
FilePath = "3D Periodic Table.pdf"
};
步骤 3. – 定义水印的文本、字体和外观。
TextWatermarkOptions = new TextWatermarkOptions
{
Text = "Confidential",
FontFamilyName = "Arial",
FontSize = 20d,
}
步骤 4. – 添加文本水印。
var request = new AddRequest(options);
var response = watermarkApi.Add(request);
💡 您可以将文本水印应用于所有页面,或使用 API 参数将其限制为特定页面范围。
// 对于更多示例,请访问 [https://github.com/groupdocs-watermark-cloud/groupdocs-watermark-cloud-dotnet](https://github.com/groupdocs-watermark-cloud/groupdocs-watermark-cloud-dotnet)
var configuration = new Configuration("XXXXXXX-XXXXXXX-XXXXXX-55c38f4b7f22", "XXXXXXXXXXXX");
var watermarkApi = new GroupDocs.Watermark.Cloud.Sdk.Api.WatermarkApi(configuration);
var fileInfo = new FileInfo
{
// 需加水印的输入 PDF 名称
FilePath = "3D Periodic Table.pdf"
};
var options = new WatermarkOptions()
{
FileInfo = fileInfo,
WatermarkDetails = new List<WatermarkDetails>
{
new WatermarkDetails
{
TextWatermarkOptions = new TextWatermarkOptions
{
Text = "Confidential",
FontFamilyName = "Arial",
FontSize = 20d,
}
}
}
};
// 创建水印请求
var request = new AddRequest(options);
var response = watermarkApi.Add(request);
使用 cURL 水印 PDF
您还可以通过 REST API 调用使用 cURL 向 PDF 文档添加文本水印。
步骤 1 – 获取访问令牌
curl -X POST "https://api.groupdocs.cloud/connect/token" \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET" \
-H "Content-Type: application/x-www-form-urlencoded"
第 2 步 - 为 PDF 添加文本水印
curl -X POST "https://api.groupdocs.cloud/v1.0/watermark/pdf/add" -H "accept: application/json" -H "authorization: Bearer {ACCESS_TOKEN}" -H "Content-Type: application/json" -d '{
"FileInfo": { "FilePath": "Sample.pdf" },
"OutputPath": "output/output.pdf",
"Text": "Confidential",
"FontSize": 18,
"Opacity": 0.3,
"RotationAngle": 45,
"HorizontalAlignment": "Center",
"VerticalAlignment": "Center"
}'
将
{ACCESSTOKEN}替换为您的实际令牌,将Sample.pdf替换为上传的 PDF 文件名。
在线免费添加水印至 PDF
您可以立即使用我们的免费 Online Watermark PDF Tool 测试此功能。上传您的 PDF 文档,输入您的水印文本,然后下载带水印的文件,无需编写一行代码。

在线向 PDF 添加水印。
结论
使用 GroupDocs.Watermark Cloud SDK for .NET 将文本水印添加到您的 PDF 文档是一种简单而有效的方式,可以保护知识产权,确保真实性,并增强文档品牌。该 REST API 使您能够以编程方式自定义水印的字体、样式、颜色和位置选项。
常见问题 – FAQs
我可以在PDF的所有页面上添加文本水印吗? 是的。您可以将水印应用于每一页或特定的页范围。
是否可以调整透明度和旋转? 是的。该 API 支持水印不透明度、旋转角度、字体大小和对齐方式的自定义。
我需要安装任何外部软件吗? 不。所有操作都在云中运行,不需要桌面软件。
我可以添加图像和文本水印吗? 是的。您可以在同一文档中结合文本和图像水印。
是否有水印 API 的免费版本? 是的。创建一个 free trial account 来在线测试水印功能。
