在 PDF 中添加水印是保护文件、表明机密性或品牌化文件的常见需求。在本文中，我们将指导您如何通过几行代码在 PDF 中添加水印。无论您想在 PDF 中的图片上添加水印还是整个 PDF 文档，这份指南都涵盖了您所需的一切。
为什么在PDF中添加图像水印？
- 保护您的文件免受未授权的分发。
- 确保所有 PDF 文件中的品牌一致。
- 清楚地指示机密或草稿状态。
PDF 操作 REST API
GroupDocs.Watermark Cloud SDK for .NET 使您能够在 PDF 文档中添加、管理和自定义图像水印，步骤简单。使用此 SDK，您可以保护您的 PDF，维护品牌一致性，并在无需桌面软件的情况下以编程方式控制水印外观。
👉 - 除了 PDF，您还可以使用此 API 处理 Word、PPTX、Excel 以及各种图像文件。
PDF 图像水印功能
- 使用 .NET 轻松向 PDF 文件添加图像水印。
- 将水印应用于 PDF 的所有页面或特定页面。
- 自定义图片水印的透明度、大小、对齐方式和旋转。
- 根据需要更新或删除 PDF 文档中的现有图像水印。
安装
在您的 .NET 项目中通过 NuGet 安装 SDK：
PM> NuGet\Install-Package GroupDocs.Watermark-Cloud -Version 23.8.0
使用C#制作图像水印
请按照以下说明使用 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 = "SourceFile.pdf"
};
步骤 3. – 定义水印特征。
WatermarkOptions = new PdfWatermarkOptions
{
ImageWatermark = new ImageWatermark
{
FilePath = "logo.png",
HorizontalAlignment = "Center",
VerticalAlignment = "Center",
Opacity = 0.5
}
}
第 4 步 – 插入图片水印。
var response = watermarkApi.AddWatermark(request);
- 您可以在 PDF 的特定位置插入水印，调整不透明度或缩放图像。
// 有关更多示例，请访问 https://github.com/groupdocs-watermark-cloud/groupdocs-watermark-cloud-dotnet
var configuration = new Configuration("XXXXXXX-XXXXXXX-XXXXXX-XXXXXXX", "XXXXXXXXXXXX");
var watermarkApi = new WatermarkApi(configuration);
var fileInfo = new FileInfo
{
// input pdf file available in cloud storage
FilePath = "sample.pdf",
};
var options = new WatermarkOptions()
{
FileInfo = fileInfo,
WatermarkDetails = new List<WatermarkDetails>
{
new WatermarkDetails
{
ImageWatermarkOptions = new ImageWatermarkOptions()
{
Image = new FileInfo { FilePath = "confidential.jpg" }
}
}
},
ProtectLevel = WatermarkOptions.ProtectLevelEnum.DocumentAndImages
};
// 创建添加图片水印的请求
var request = new Requests.AddRequest(options);
// 将图像水印插入PDF文件
var response = watermarkApi.Add(request);
如何使用 cURL 插入水印
REST API 还允许您使用 cURL 命令向 PDF 文档添加图像水印。如果您更喜欢直接使用 HTTP 请求而不是 SDK，这个功能很方便。
步骤 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 -v -X POST "https://api.groupdocs.cloud/v1.0/watermark" \
-H "accept: application/json" \
-H "authorization: Bearer {ACCESS_TOKEN}" \
-H "Content-Type: application/json" \
-d "{ \"FileInfo\": { \"FilePath\": \"sourceFile.pdf\", \"StorageName\": \"internal\" }, \"OutputFolder\": \"resultant\", \"WatermarkDetails\": [ { \"ImageWatermarkOptions\": { \"Image\": { \"FilePath\": \"confidential.jpeg\", \"StorageName\": \"internal\" } }, \"Position\": { \"X\": 120, \"Y\": 120, \"Width\": 200, \"Height\": 200, \"HorizontalAlignment\": \"center\", \"VerticalAlignment\": \"center\", \"Margins\": { \"Right\": 100, \"Left\": 100, \"Top\": 100, \"Bottom\": 100 }, \"ScaleFactor\": 1, \"RotateAngle\": 180, \"ConsiderParentMargins\": true, \"IsBackground\": true }, \"Opacity\": 1 } ], \"PdfOptions\": { \"PrintOnlyAnnotationWatermarks\": true, \"Rasterize\": true }}"
将
{ACCESSTOKEN}替换为上面生成的令牌。
免费的在线PDF水印应用程序
如果您有兴趣在没有代码片段的情况下测试 Cloud SDK 的功能，可以考虑使用我们的免费 Online PDF Watermark App。您需要做的就是上传输入 PDF 文档，指定图像文件，然后下载带水印的 PDF，而无需编写一行代码。
在网上给 PDF 添加水印。
结论
在本文中，我们了解到使用 GroupDocs.Watermark Cloud SDK for .NET 为 PDF 文件添加水印是一种快速、可靠且灵活的解决方案，适合开发人员和企业。它允许您添加图像水印，控制水印的位置、透明度和大小，并将其应用于所有或选定的页面，而无需像 Adobe Acrobat 这样的桌面软件。尝试使用此 API 生成专业、安全且易于管理的 PDF 文档。
常见问题 – FAQ
我可以在 PDF 的特定页面添加图像水印吗？ 是的。您可以选择将图像水印应用于所有页面或仅选定的页面在 PDF 中。
是否可以在不修改原始文件的情况下给 PDF 添加水印？ 是的。API 生成一个新的带水印的 PDF，同时保持原始文档不变。
我需要安装 Adobe Acrobat 或其他外部软件吗？ 不。所有操作都在云端运行，无需桌面软件。
我可以替换或删除 PDF 中现有的图像水印吗？ 是的。SDK 允许您随时更新或删除 PDF 文档中的现有水印。
是否有水印 API 的免费版本？ 是的。创建一个 free trial account 以在线测试水印功能。