Vous pouvez ajouter un texte ou une image en filigrane à vos documents Word par programmation sur le cloud. Les filigranes sont utilisés pour identifier le créateur du document ou d’autres informations telles que le droit d’auteur ou le logo, etc. Habituellement, le filigrane est utilisé sous la forme d’une image superposée, d’un logo, d’un motif ou d’un texte placé à l’intérieur du document. Dans cet article, vous apprendrez à ajouter un filigrane aux documents Word à l’aide d’une API REST en C#.
Les sujets suivants seront traités dans cet article :
- API REST de filigrane et SDK .NET
- Ajouter un filigrane de texte aux documents Word à l’aide de l’API REST en C#
- Ajouter un filigrane d’image aux documents Word à l’aide de l’API REST
API REST de filigrane et SDK .NET
Pour ajouter un filigrane de texte ou d’image aux fichiers DOCX, j’utiliserai l’API .NET SDK of GroupDocs.Watermark Cloud. Il vous permet d’ajouter, de supprimer, de rechercher et de remplacer par programmation des filigranes à partir d’images et de documents des formats de fichiers pris en charge tels que PDF, Microsoft Word et Powerpoint. De plus, vous pouvez contrôler la personnalisation des filigranes en spécifiant le style de texte, la police, la taille, la couleur ou la position selon vos besoins. Actuellement, il fournit également le SDK Java pour l’API Cloud.
Vous pouvez installer GroupDocs.Watermark Cloud dans votre projet Visual Studio à partir du gestionnaire de packages NuGet ou à l’aide de la commande suivante dans la console du gestionnaire de packages :
Install-Package GroupDocs.Watermark-Cloud
Veuillez obtenir votre ID client et votre secret à partir du tableau de bord avant de suivre les étapes mentionnées. Une fois que vous avez votre identifiant et votre secret, ajoutez le code comme indiqué ci-dessous :
string clientId = "da0c487d-c1c0-45ae-b7bf-43eaf53c5ad5";
string clientSecret = "479db2b01dcb93a3d4d20efb16dea971";
string myStorage = "";
var configuration = new Configuration(clientId, clientSecret);
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";
Ajouter un filigrane de texte aux documents Word à l’aide de l’API REST en C#
Vous pouvez ajouter n’importe quel texte en filigrane à vos documents Word par programme en suivant les étapes simples mentionnées ci-dessous :
- Télécharger the DOCX file to the Cloud
- Ajouter un filigrane de texte à DOCX à l’aide de C#
- Télécharger the watermarked file
Télécharger le document
Tout d’abord, téléchargez le document Word dans le Cloud en utilisant l’exemple de code ci-dessous :
// initialiser l'API
var fileApi = new FileApi(configuration);
// fichier ouvert
var fileStream = File.Open(@"C:\Files\sample.docx", FileMode.Open);
// créer une demande de téléchargement de fichier
var request = new UploadFileRequest("sample.docx", fileStream, MyStorage);
// téléverser un fichier
fileApi.UploadFile(request);
fileStream.Close();
En conséquence, le fichier DOCX sera téléchargé sur le stockage cloud et sera disponible dans la section fichiers de votre tableau de bord.
Ajouter un filigrane de texte à DOCX à l’aide de C#
Vous pouvez ajouter un filigrane de texte au fichier DOCX par programmation en suivant les étapes ci-dessous.
- Créer une instance de WatermarkApi
- Créer une instance de FileInfo
- Définir le chemin du fichier DOCX
- Créer WatermarkOptions et définir FileInfo
- Créer des options de filigrane de texte
- Définir le texte, la famille de polices, la taille de la police et l’alignement du texte
- Définir la couleur de premier plan du texte du filigrane
- Définir la position du filigrane
- Définir WatermarkDetails et définir TextWatermarkOptions et Position
- Créer AddRequest avec WatermarkOptions
- Obtenez des résultats en appelant la méthode WatermarkApi.add()
L’exemple de code suivant montre comment ajouter du texte en filigrane à un document Word à l’aide d’une API REST en C#.
// initialiser l'API
var apiInstance = new WatermarkApi(configuration);
// chemin du fichier d'entrée
var fileInfo = new FileInfo
{
FilePath = "sample.docx"
};
// créer des options de filigrane
var options = new WatermarkOptions()
{
FileInfo = fileInfo,
// définir les détails du filigrane
WatermarkDetails = new List<WatermarkDetails>
{
new WatermarkDetails
{
// définir le filigrane du texte
TextWatermarkOptions = new TextWatermarkOptions
{
Text = "Copyright© 2021",
FontFamilyName = "Arial",
FontSize = 22d,
TextAlignment = "Center",
ForegroundColor = new Color()
{
Name = "Red"
}
},
// définir la position du filigrane
Position = new Position()
{
X = 230.0,
Y = 500.0
}
}
}
};
// créer une demande d'ajout
var request = new AddRequest(options);
// Ajouter un filigrane
var response = apiInstance.Add(request);
Console.WriteLine("Resultant file path: " + response.DownloadUrl);
Ajouter un filigrane de texte aux documents Word à l’aide de l’API REST en C#
Télécharger le fichier mis à jour
L’exemple de code ci-dessus enregistrera le fichier Word avec un filigrane de texte sur le cloud. Vous pouvez le télécharger à l’aide de l’exemple de code suivant :
// initialiser l'API
var fileApi = new FileApi(configuration);
// chemin de fichier par défaut sur le cloud
var file = "watermark/added_watermark/sample_docx/sample.docx";
// créer une demande de fichier de téléchargement
var downloadRequest = new DownloadFileRequest(file, myStorage);
// télécharger un fichier
Stream downloadResponse = fileApi.DownloadFile(downloadRequest);
// enregistrer le fichier dans le répertoire de travail
using (var fileStream = System.IO.File.Create("C:\\Files\\DownloadedFile.docx"))
{
downloadResponse.Seek(0, SeekOrigin.Begin);
downloadResponse.CopyTo(fileStream);
}
Ajouter un filigrane d’image aux documents Word à l’aide de l’API REST
Vous pouvez ajouter une image ou un logo en filigrane à vos documents Word par programmation en suivant les étapes ci-dessous.
- Créer une instance de WatermarkApi
- Créer une instance de FileInfo
- Définir le chemin du fichier DOCX
- Créer WatermarkOptions et définir FileInfo
- Créer des options de filigrane d’image
- Définir FilePath d’une image PNG à filigrane avec
- Définir la position du filigrane
- Créer des détails de filigrane
- Définir les options et la position de ImageWatermark
- Définir les détails du filigrane sur la liste
- Créer AddRequest avec WatermarkOptions
- Obtenez des résultats en appelant la méthode WatermarkApi.add()
L’exemple de code suivant montre comment ajouter une image en tant que filigrane à DOCX à l’aide d’une API REST en C#. Veuillez suivre les étapes mentionnées précédemment pour charger et télécharger les fichiers.
// initialiser l'API
var apiInstance = new WatermarkApi(configuration);
// chemin du fichier d'entrée
var fileInfo = new FileInfo
{
FilePath = "sample.docx"
};
// créer des options de filigrane
var options = new WatermarkOptions()
{
FileInfo = fileInfo,
// définir les détails du filigrane
WatermarkDetails = new List<WatermarkDetails>
{
new WatermarkDetails
{
// définir le filigrane de l'image
ImageWatermarkOptions = new ImageWatermarkOptions()
{
Image = new FileInfo {
FilePath = "logo.png"
}
},
// définir la position du filigrane
Position = new Position()
{
X = 180.0,
Y = 280.0
}
}
}
};
// créer une demande d'ajout
var request = new AddRequest(options);
// Ajouter un filigrane
var response = apiInstance.Add(request);
Console.WriteLine("Resultant file path: " + response.DownloadUrl);
Ajouter un filigrane d’image aux documents Word à l’aide de l’API REST en C#
Essayez en ligne
Veuillez essayer l’outil de filigrane en ligne gratuit suivant, qui est développé à l’aide de l’API ci-dessus. https://products.groupdocs.app/watermark/docx
Conclusion
En conclusion, vous avez appris à ajouter un filigrane de texte ou d’image à un document Word sur le cloud. Vous avez également appris à télécharger par programme les fichiers DOCX sur le cloud, puis à télécharger le fichier mis à jour à partir du cloud. Vous pouvez en savoir plus sur l’API GroupDocs.Watermark Cloud à partir de la documentation. Nous fournissons également une section API Reference qui vous permet de visualiser et d’interagir avec nos API directement via le navigateur. En cas d’ambiguïté, n’hésitez pas à contacter support.