如何使用 IronWord 在 C# 中為 Word 文件添加水印

// Replace the license key variable with the trial key you obtained
// For enterprise deployments, store this in secure configuration management
IronWord.License.LicenseKey = System.Environment.GetEnvironmentVariable("IRONWORD_LICENSE_KEY") 
    ?? throw new InvalidOperationException("IronWord license key not configured");

' Replace the license key variable with the trial key you obtained
' For enterprise deployments, store this in secure configuration management
IronWord.License.LicenseKey = If(Environment.GetEnvironmentVariable("IRONWORD_LICENSE_KEY"), 
    Throw New InvalidOperationException("IronWord license key not configured"))

using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;
using System;
using System.IO;
using Microsoft.Extensions.Logging;

public class EnterpriseWatermarkService
{
    private readonly ILogger<EnterpriseWatermarkService> _logger;

    public EnterpriseWatermarkService(ILogger<EnterpriseWatermarkService> logger)
    {
        _logger = logger;
        // Set the license key from secure configuration
        IronWord.License.LicenseKey = Environment.GetEnvironmentVariable("IRONWORD_LICENSE_KEY");
    }

    public void AddWatermarkToDocument(string outputPath, string watermarkImagePath)
    {
        try
        {
            // Validate input paths for security
            if (!File.Exists(watermarkImagePath))
            {
                throw new FileNotFoundException($"Watermark image not found: {watermarkImagePath}");
            }

            // Create a new Word document with audit metadata
            WordDocument doc = new WordDocument();

            // Add document properties for compliance tracking
            doc.Properties.Author = "Enterprise Document Service";
            doc.Properties.LastModifiedBy = Environment.UserName;
            doc.Properties.CreationDate = DateTime.UtcNow;

            // Load the image to be used as a watermark
            IronWord.Models.Image image = new IronWord.Models.Image(watermarkImagePath);

            // Set the width and height of the image for optimal visibility
            image.Width = 500; // In pixels - configurable per enterprise standards
            image.Height = 250; // In pixels - maintains aspect ratio

            // Add transparency for professional appearance
            // Note: IronWord applies appropriate transparency automatically

            // Add the image as a watermark to the document
            doc.AddImage(image);

            // Save the document with encryption if required by policy
            doc.SaveAs(outputPath);

            _logger.LogInformation("Watermark applied successfully to {OutputPath}", outputPath);
        }
        catch (Exception ex)
        {
            _logger.LogError(ex, "Failed to apply watermark to document");
            throw; // Re-throw for proper error handling upstream
        }
    }
}

Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums
Imports System
Imports System.IO
Imports Microsoft.Extensions.Logging

Public Class EnterpriseWatermarkService
    Private ReadOnly _logger As ILogger(Of EnterpriseWatermarkService)

    Public Sub New(logger As ILogger(Of EnterpriseWatermarkService))
        _logger = logger
        ' Set the license key from secure configuration
        IronWord.License.LicenseKey = Environment.GetEnvironmentVariable("IRONWORD_LICENSE_KEY")
    End Sub

    Public Sub AddWatermarkToDocument(outputPath As String, watermarkImagePath As String)
        Try
            ' Validate input paths for security
            If Not File.Exists(watermarkImagePath) Then
                Throw New FileNotFoundException($"Watermark image not found: {watermarkImagePath}")
            End If

            ' Create a new Word document with audit metadata
            Dim doc As New WordDocument()

            ' Add document properties for compliance tracking
            doc.Properties.Author = "Enterprise Document Service"
            doc.Properties.LastModifiedBy = Environment.UserName
            doc.Properties.CreationDate = DateTime.UtcNow

            ' Load the image to be used as a watermark
            Dim image As New IronWord.Models.Image(watermarkImagePath)

            ' Set the width and height of the image for optimal visibility
            image.Width = 500 ' In pixels - configurable per enterprise standards
            image.Height = 250 ' In pixels - maintains aspect ratio

            ' Add transparency for professional appearance
            ' Note: IronWord applies appropriate transparency automatically

            ' Add the image as a watermark to the document
            doc.AddImage(image)

            ' Save the document with encryption if required by policy
            doc.SaveAs(outputPath)

            _logger.LogInformation("Watermark applied successfully to {OutputPath}", outputPath)
        Catch ex As Exception
            _logger.LogError(ex, "Failed to apply watermark to document")
            Throw ' Re-throw for proper error handling upstream
        End Try
    End Sub
End Class

// Set the image to wrap behind the text for optimal readability
image.WrapText = WrapText.BehindText;

// Additional enterprise configurations
image.Transparency = 0.3f; // 30% transparency for subtle watermarking
image.Rotation = -45; // Diagonal watermark for added security

' Set the image to wrap behind the text for optimal readability
image.WrapText = WrapText.BehindText

' Additional enterprise configurations
image.Transparency = 0.3F ' 30% transparency for subtle watermarking
image.Rotation = -45 ' Diagonal watermark for added security

using IronWord;
using IronWord.Models;

public class AdvancedWatermarkConfiguration
{
    public void ConfigureEnterpriseWatermark(WordDocument doc, string watermarkPath)
    {
        // Set the license key from secure storage
        IronWord.License.LicenseKey = GetSecureLicenseKey();

        // Load the image to be used as a watermark
        IronWord.Models.Image image = new IronWord.Models.Image(watermarkPath);

        // Create an ElementPosition object for precise placement
        ElementPosition elementPosition = new ElementPosition();

        // Center the watermark for maximum visibility
        elementPosition.SetXPosition(doc.PageWidth / 2 - 25); // Center horizontally
        elementPosition.SetYPosition(doc.PageHeight / 2 - 25); // Center vertically

        // Set appropriate dimensions for corporate watermarks
        image.Width = 50; // In pixels - adjust based on document type
        image.Height = 50; // In pixels - maintain aspect ratio

        // Set the image position using the ElementPosition object
        image.Position = elementPosition;

        // Configure margins to ensure watermark doesn't interfere with headers/footers
        image.DistanceFromTop = 100;    // Comply with corporate header standards
        image.DistanceFromBottom = 100; // Maintain footer space
        image.DistanceFromLeft = 100;   // Respect margin requirements
        image.DistanceFromRight = 100;  // Ensure print compatibility

        // Apply additional security features
        image.WrapText = WrapText.BehindText;
        image.AllowOverlap = false; // Prevent watermark stacking

        // Add the configured watermark
        doc.AddImage(image);
    }

    private string GetSecureLicenseKey()
    {
        // Implement secure key retrieval from Azure Key Vault, 
        // AWS Secrets Manager, or enterprise configuration service
        return Environment.GetEnvironmentVariable("IRONWORD_LICENSE_KEY");
    }
}

Imports IronWord
Imports IronWord.Models

Public Class AdvancedWatermarkConfiguration
    Public Sub ConfigureEnterpriseWatermark(doc As WordDocument, watermarkPath As String)
        ' Set the license key from secure storage
        IronWord.License.LicenseKey = GetSecureLicenseKey()

        ' Load the image to be used as a watermark
        Dim image As New IronWord.Models.Image(watermarkPath)

        ' Create an ElementPosition object for precise placement
        Dim elementPosition As New ElementPosition()

        ' Center the watermark for maximum visibility
        elementPosition.SetXPosition(doc.PageWidth / 2 - 25) ' Center horizontally
        elementPosition.SetYPosition(doc.PageHeight / 2 - 25) ' Center vertically

        ' Set appropriate dimensions for corporate watermarks
        image.Width = 50 ' In pixels - adjust based on document type
        image.Height = 50 ' In pixels - maintain aspect ratio

        ' Set the image position using the ElementPosition object
        image.Position = elementPosition

        ' Configure margins to ensure watermark doesn't interfere with headers/footers
        image.DistanceFromTop = 100 ' Comply with corporate header standards
        image.DistanceFromBottom = 100 ' Maintain footer space
        image.DistanceFromLeft = 100 ' Respect margin requirements
        image.DistanceFromRight = 100 ' Ensure print compatibility

        ' Apply additional security features
        image.WrapText = WrapText.BehindText
        image.AllowOverlap = False ' Prevent watermark stacking

        ' Add the configured watermark
        doc.AddImage(image)
    End Sub

    Private Function GetSecureLicenseKey() As String
        ' Implement secure key retrieval from Azure Key Vault, 
        ' AWS Secrets Manager, or enterprise configuration service
        Return Environment.GetEnvironmentVariable("IRONWORD_LICENSE_KEY")
    End Function
End Class