Passer au contenu du pied de page
UTILISATION D'IRONWORD

Comment ajouter un filigrane à un fichier Word en C#

In today's modern enterprise, Word Documents are synonymous with information and carry important information between divisions and companies. However, with digital documents, there is also the risk of someone tampering with or forging an invalid or fake Word document.

As such, one way to combat it is to add watermarks to Word documents. However, this doesn't increase the security of a Word document. A watermark allows primary differentiation between the actual Word document and the forged one. Furthermore, adding a watermark programmatically is quite challenging, as most instances require users to manually use Microsoft Word and add a watermark on each document, making it a painstakingly long process.

Fortunately, IronWord can programmatically add images as watermarks in Word. This allows developers to add them in the pipeline programmatically, reducing repetitive work and increasing efficiency and consistency.

Although there are various kinds of watermarks, such as shape watermark and text watermark, this article will only use image and picture watermarks, discuss IronWord as a library, and provide practical examples of adding images to the Word document.

Adding Watermarks to Word Documents

IronWord

How to Add Watermark to A Word File in C#: Figure 1 - IronWord: The C# DOCX Library

IronWord is a reliable and easy-to-use C# Docx library that allows developers to build and edit Word documents using C# without relying on traditional dependencies such as Microsoft Office or Word Interop.

Furthermore, it has extensive documentation and fully supports .NET 8, 7, 6, Framework, Core, and Azure. This makes it cross-platform compatible with most applications and flexible no matter the application you are dealing with.

Working with Image Watermarks

License Key

Please remember that IronWord requires a licensing key for operation. You can get a key as part of a free trial by visiting this link.

// Replace the license key variable with the trial key you obtained
IronWord.License.LicenseKey = "REPLACE-WITH-YOUR-KEY";
// Replace the license key variable with the trial key you obtained
IronWord.License.LicenseKey = "REPLACE-WITH-YOUR-KEY";
' Replace the license key variable with the trial key you obtained
IronWord.License.LicenseKey = "REPLACE-WITH-YOUR-KEY"
$vbLabelText   $csharpLabel

After receiving a trial key, set this variable in your project.

Add Image Watermark to Word Document

Let's examine an example of adding an image watermark to a Word Document. We won't mention static void main to reduce repetitive code but will showcase only the main code.

We will use this image as the watermark image and add it to the Word document.

How to Add Watermark to A Word File in C#: Figure 2 - Input Image

using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;

// Set the license key
IronWord.License.LicenseKey = "YOUR-KEY";

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

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

// Set the width and height of the image
image.Width = 500; // In pixels
image.Height = 250; // In pixels

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

// Save the document as a .docx file
doc.SaveAs("documentImageResized.docx");
using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;

// Set the license key
IronWord.License.LicenseKey = "YOUR-KEY";

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

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

// Set the width and height of the image
image.Width = 500; // In pixels
image.Height = 250; // In pixels

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

// Save the document as a .docx file
doc.SaveAs("documentImageResized.docx");
Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums

' Set the license key
IronWord.License.LicenseKey = "YOUR-KEY"

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

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

' Set the width and height of the image
image.Width = 500 ' In pixels
image.Height = 250 ' In pixels

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

' Save the document as a .docx file
doc.SaveAs("documentImageResized.docx")
$vbLabelText   $csharpLabel
  1. We first create a new instance of the WordDocument. This is the document class from IronWord. In the next steps, we create a new variable called doc and add the picture watermark to it.
  2. We load our input image from above into a new Image class.
  3. We set the width and height of the image accordingly. This width and height property allows users to accomplish image watermark scaling. In our example, the width is set to 500, and the height is set to 250.
  4. We add the image watermark to the document using AddImage.
  5. Finally, we save and export the document documentImageResized as a Word file.

The output of the Word document is below.

How to Add Watermark to A Word File in C#: Figure 3 - Output Word Document

Keep in mind that the dimensions set in the example are made to fit the whole Word document and display IronWord's capabilities.

In addition to adding the image, we can use the WrapText property to ensure that the image watermark stays behind the text in the background.

// Set the image to wrap behind the text
image.WrapText = WrapText.BehindText;
// Set the image to wrap behind the text
image.WrapText = WrapText.BehindText;
' Set the image to wrap behind the text
image.WrapText = WrapText.BehindText
$vbLabelText   $csharpLabel

Through this property, the image watermark should wrap behind the text, only showing in the background, allowing the text to be unhindered.

Furthermore, developers can try more customizations for the image watermark to make it unique. IronWord allows you to offset the dimensions of the image relative to the Word document and manage the position of the image watermark as well.

using IronWord;
using IronWord.Models;

// Set the license key
IronWord.License.LicenseKey = "YOUR-KEY";

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

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

// Create an ElementPosition object to set the position
ElementPosition elementPosition = new ElementPosition();
elementPosition.SetXPosition(50);
elementPosition.SetYPosition(50);

// Set the dimensions of the image
image.Width = 50; // In pixels
image.Height = 50; // In pixels

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

// Offset the image from each side by 100 pixels
image.DistanceFromTop = 100;
image.DistanceFromBottom = 100;
image.DistanceFromLeft = 100;
image.DistanceFromRight = 100;
using IronWord;
using IronWord.Models;

// Set the license key
IronWord.License.LicenseKey = "YOUR-KEY";

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

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

// Create an ElementPosition object to set the position
ElementPosition elementPosition = new ElementPosition();
elementPosition.SetXPosition(50);
elementPosition.SetYPosition(50);

// Set the dimensions of the image
image.Width = 50; // In pixels
image.Height = 50; // In pixels

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

// Offset the image from each side by 100 pixels
image.DistanceFromTop = 100;
image.DistanceFromBottom = 100;
image.DistanceFromLeft = 100;
image.DistanceFromRight = 100;
Imports IronWord
Imports IronWord.Models

' Set the license key
IronWord.License.LicenseKey = "YOUR-KEY"

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

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

' Create an ElementPosition object to set the position
Dim elementPosition As New ElementPosition()
elementPosition.SetXPosition(50)
elementPosition.SetYPosition(50)

' Set the dimensions of the image
image.Width = 50 ' In pixels
image.Height = 50 ' In pixels

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

' Offset the image from each side by 100 pixels
image.DistanceFromTop = 100
image.DistanceFromBottom = 100
image.DistanceFromLeft = 100
image.DistanceFromRight = 100
$vbLabelText   $csharpLabel

Similar to the code above, we set the dimensions of the image's x and y locations to 50. We also offset the dimensions from each side by 100px to create a margin around it.

Conclusion

How to Add Watermark to A Word File in C#: Figure 4 - IronWord licensing information

Throughout the examples, we demonstrated how straightforward it is to use the IronWord library to manipulate and read Word documents programmatically in C#. The library's flexibility and scalability make it a valuable tool that allows developers to use IronWord in practical, real-life examples, such as adding a watermark and a text watermark. It's essential to grasp how Word works with other applications because it provides developers with additional solutions to their challenges.

IronWord offers a free trial license.

Questions Fréquemment Posées

Comment puis-je ajouter un filigrane à un document Word en C# par programmation?

En utilisant IronWord, les développeurs peuvent ajouter des filigranes d'image aux documents Word en créant une instance de document Word, en chargeant une image et en utilisant la méthode AddImage pour l'insérer comme un filigrane.

Quels sont les avantages d'utiliser un filigrane dans les documents Word?

Les filigranes aident à différencier les documents authentiques des contrefaçons et améliorent la gestion des documents en marquant les documents comme ébauches, confidentiels ou finalisés.

Comment IronWord gère-t-il les filigranes d'image dans les documents Word?

IronWord permet aux développeurs de charger des images, de définir leurs dimensions et positions, et de les ajouter comme filigranes aux documents Word. L'image peut être positionnée derrière le texte en utilisant la propriété WrapText.BehindText.

Quelles versions de .NET sont compatibles avec IronWord?

IronWord prend en charge .NET 8, 7, 6, le .NET Framework, .NET Core, et Azure, ce qui le rend très polyvalent et compatible avec plusieurs plateformes.

Une licence est-elle requise pour utiliser IronWord?

Oui, IronWord nécessite une clé de licence pour une fonctionnalité complète. Une clé d'essai peut être obtenue sur le site d'IronWord pour une évaluation initiale.

Comment pouvez-vous personnaliser la position d'un filigrane d'image dans un document Word en utilisant IronWord?

IronWord permet de personnaliser la position du filigrane d'image en définissant les coordonnées x et y et en ajustant les dimensions pour décaler l'image de chaque côté par une valeur de pixels spécifique.

IronWord peut-il être utilisé pour ajouter des filigranes de texte aux documents Word?

Bien que l'article se concentre sur les filigranes d'image, IronWord peut également être utilisé pour ajouter des filigranes de texte en rendant le texte sous forme d'image et en l'appliquant de manière similaire aux filigranes d'image.

Quels exemples pratiques l'article fournit-il pour l'utilisation de IronWord?

L'article fournit des exemples de création de documents Word, de chargement d'images comme filigranes, d'ajustement de leurs dimensions et de définition de leurs positions derrière le texte pour démontrer les capacités d'IronWord.

Jordi Bardia
Ingénieur logiciel
Jordi est le plus compétent en Python, C# et C++, et lorsqu'il ne met pas à profit ses compétences chez Iron Software, il programme des jeux. Partageant les responsabilités des tests de produit, du développement de produit et de la recherche, Jordi apporte une immense valeur à l'amé...
Lire la suite