Un filigrane est une image ou un texte superposé utilisé pour s’afficher dans des documents à diverses fins. Parfois, vous devrez peut-être remplacer ou modifier le filigrane inséré par un nouveau texte ou une nouvelle image. Cet article se concentrera sur la recherche et le remplacement de texte ou d’images de filigrane à l’aide d’une API REST.
Les sujets suivants seront traités dans cet article :
- API REST de filigrane et SDK .NET
- Rechercher et remplacer un filigrane de texte à l’aide d’une API REST
- Rechercher et remplacer une image de filigrane à l’aide d’une API REST
API REST de filigrane et SDK .NET
Pour rechercher et remplacer le filigrane, j’utiliserai l’API .NET SDK of GroupDocs.Watermark Cloud. Il vous permet d’ajouter, de supprimer, de rechercher et de remplacer par programme des filigranes à partir d’images et de documents de formats pris en charge. Actuellement, il fournit également le SDK Java pour l’API Cloud.
Le SDK Cloud GroupDocs.Watermark pour .NET peut être installé sur votre projet Visual Studio à partir du gestionnaire de packages NuGet, comme indiqué ci-dessous :
Vous pouvez également installer le package NuGet à 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 client à partir du tableau de bord avant de commencer à suivre les étapes et les exemples de code disponibles. Ajoutez votre identifiant et votre secret dans le code comme illustré ci-dessous :
string MyClientId = "YOUR-CLIENT-ID";
string MyClientSecret = "YOUR-CLIENT-SECRET";
var config = new Configuration(MyClientId, MyClientSecret);
var watermarkApi = new WatermarkApi(config);
var fileApi = new FileApi(config);
var storageApi = new StorageApi(config);
Rechercher et remplacer un filigrane de texte à l’aide d’une API REST
Vous pouvez rechercher et remplacer le texte du filigrane de vos documents PDF en suivant les étapes simples mentionnées ci-dessous :
- Téléchargerthe PDF document to the Cloud
- Rechercher et remplacer le filigrane de texte à partir du fichier PDF téléchargé
- Téléchargerthe updated file
Télécharger le document PDF
Tout d’abord, téléchargez le document PDF contenant le filigrane dans le Cloud en utilisant l’une des méthodes suivantes :
- Utilisation du tableau de bord
- Téléchargez le fichier à l’aide de Upload File API depuis le navigateur
- Importez par programmation à l’aide de l’exemple de code ci-dessous :
var path = @"C:\Files\";
string MyStorage = null;
var file = Directory.GetFiles(path, "Sample.pdf", SearchOption.AllDirectories).FirstOrDefault();
if (file.Length != 0)
{
var relativeFilePath = file.Replace(path, string.Empty).Trim(Path.DirectorySeparatorChar);
var fileStream = File.Open(file, FileMode.Open);
fileApi.UploadFile(new UploadFileRequest(relativeFilePath, fileStream, MyStorage));
fileStream.Close();
}
En conséquence, le fichier PDF sera téléchargé sur Cloud Storage et sera disponible dans la section des fichiers de votre tableau de bord.
Rechercher et remplacer le filigrane de texte
L’extrait de code suivant montre comment rechercher et remplacer un filigrane de texte à partir d’un fichier PDF téléchargé à l’aide d’une API REST.
public static string FindAndReplaceTextWatermark(WatermarkApi watermarkApi)
{
var options = new ReplaceOptions
{
FileInfo = new GroupDocs.Watermark.Cloud.Sdk.Model.FileInfo
{
FilePath = "Sample.pdf"
},
TextSearchCriteria = new TextSearchCriteria
{
SearchText = "Watermark Text"
},
ReplaceTextOptions = new ReplaceTextOptions
{
Text = "Confidential",
}
};
var request = new ReplaceRequest(options);
var result = watermarkApi.Replace(request);
return result.Path;
}
Vous pouvez également définir la police, la taille du texte, les couleurs de premier plan et d’arrière-plan pour le texte du filigrane à l’aide de l’exemple de code suivant :
ReplaceTextOptions = new ReplaceTextOptions
{
Text = "Confidential",
FontFamily = "Arial",
Size = 20d,
ForegroundColor = new Color { A = 0, R = 0, G = 100, B = 0 }
}
Télécharger le fichier mis à jour
Les exemples de code ci-dessus enregistreront le fichier PDF avec un nouveau texte ou une nouvelle image en filigrane sur le cloud. Vous pouvez le télécharger à l’aide de l’exemple de code suivant :
var downloadRequest = new DownloadFileRequest(file, MyStorage);
Stream downloadResponse = fileApi.DownloadFile(downloadRequest);
using (var fileStream = System.IO.File.Create("C:\\Files\\DownloadedFile.pdf"))
{
downloadResponse.Seek(0, SeekOrigin.Begin);
downloadResponse.CopyTo(fileStream);
}
Rechercher et remplacer une image de filigrane à l’aide d’une API REST
L’exemple de code simple donné ci-dessous montre comment rechercher et remplacer l’image du filigrane à l’aide d’une API REST. Veuillez suivre les étapes mentionnées précédemment pour charger et télécharger un fichier.
public static string FindAndReplaceImageWatermark(WatermarkApi watermarkApi)
{
var options = new ReplaceOptions
{
FileInfo = new GroupDocs.Watermark.Cloud.Sdk.Model.FileInfo
{
FilePath = "Sample.pdf"
},
ImageSearchCriteria = new ImageSearchCriteria
{
ImageFileInfo = new GroupDocs.Watermark.Cloud.Sdk.Model.FileInfo
{
FilePath = "sample_watermark.png"
}
},
ReplaceImageOptions = new ReplaceImageOptions
{
Image = new GroupDocs.Watermark.Cloud.Sdk.Model.FileInfo
{
FilePath = "Logo.png"
}
}
};
var request = new ReplaceRequest(options);
var result = watermarkApi.Replace(request);
return result.Path;
}
Conclusion
En conclusion, vous avez appris à rechercher et à remplacer le texte ou l’image en filigrane d’un document PDF sur le cloud avec l’API REST .NET Watermark à l’aide de C#. De plus, vous avez également appris à télécharger par programme les fichiers sur le cloud, puis à les télécharger à partir du cloud. En outre, vous pouvez découvrir diverses autres fonctionnalités utiles de l’API GroupDocs.Watermark Cloud à partir de la documentation. En cas d’ambiguïté, n’hésitez pas à contacter support.