Ein Wasserzeichen ist ein überlagertes Bild oder Text, das zur Anzeige in Dokumenten für verschiedene Zwecke verwendet wird. Manchmal müssen Sie möglicherweise das eingefügte Wasserzeichen durch einen neuen Text oder ein neues Bild ersetzen oder bearbeiten. Dieser Artikel konzentriert sich darauf, wie man Wasserzeichentext oder -bilder mithilfe einer REST-API findet und ersetzt.
Die folgenden Themen sollen in diesem Artikel behandelt werden:
- Wasserzeichen-REST-API und .NET SDK
- Suchen und ersetzen Sie Textwasserzeichen mithilfe einer REST-API
- Suchen und ersetzen Sie Wasserzeichenbilder mithilfe einer REST-API
Wasserzeichen-REST-API und .NET SDK
Zum Suchen und Ersetzen von Wasserzeichen verwende ich die API .NET SDK von GroupDocs.Watermark Cloud. Es ermöglicht Ihnen, Wasserzeichen in Bildern und Dokumenten unterstützter Formate programmgesteuert hinzuzufügen, zu entfernen, zu suchen und zu ersetzen. Derzeit wird auch Java SDK für die Cloud API bereitgestellt.
Das GroupDocs.Watermark Cloud SDK für .NET kann wie unten gezeigt über den NuGet-Paketmanager in Ihrem Visual Studio-Projekt installiert werden:
Sie können das Paket NuGet auch mit dem folgenden Befehl in der Package Manager-Konsole installieren:
Install-Package GroupDocs.Watermark-Cloud
Bitte rufen Sie Ihre Client-ID und Ihr Client-Geheimnis vom Dashboard ab, bevor Sie mit dem Befolgen der Schritte und verfügbaren Codebeispiele beginnen. Fügen Sie Ihre ID und Ihr Geheimnis wie unten gezeigt in den Code ein:
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);
Suchen und ersetzen Sie Textwasserzeichen mithilfe einer REST-API
Sie können Wasserzeichentext in Ihren PDF Dokumenten finden und ersetzen, indem Sie die folgenden einfachen Schritte ausführen:
- Hochladenthe PDF document to the Cloud
- Textwasserzeichen suchen und ersetzen aus der hochgeladenen PDF-Datei
- Herunterladenthe updated file
Laden Sie das PDF Dokument hoch
Laden Sie zunächst das PDF Dokument mit dem Wasserzeichen mit einer der folgenden Methoden in die Cloud hoch:
- Verwenden des Dashboards
- Laden Sie die Datei mit der Upload File API über den Browser hoch
- Laden Sie es programmgesteuert hoch, indem Sie das unten angegebene Codebeispiel verwenden:
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();
}
Als Ergebnis wird die PDF-Datei in den Cloud-Speicher hochgeladen und ist im Dateienbereich Ihres Dashboards verfügbar.
Suchen und ersetzen Sie Textwasserzeichen
Der folgende Codeausschnitt zeigt, wie Sie mithilfe einer REST-API ein Textwasserzeichen aus einer hochgeladenen PDF-Datei suchen und ersetzen.
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;
}
Sie können auch Schriftart, Textgröße sowie Vordergrund und Hintergrundfarben für den Wasserzeichentext festlegen, indem Sie das folgende Codebeispiel verwenden:
ReplaceTextOptions = new ReplaceTextOptions
{
Text = "Confidential",
FontFamily = "Arial",
Size = 20d,
ForegroundColor = new Color { A = 0, R = 0, G = 100, B = 0 }
}
Laden Sie die aktualisierte Datei herunter
Die oben genannten Codebeispiele speichern die PDF-Datei mit einem neuen Wasserzeichentext oder Bild in der Cloud. Sie können es mit dem folgenden Codebeispiel herunterladen:
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);
}
Suchen und ersetzen Sie Wasserzeichenbilder mithilfe einer REST-API
Das unten angegebene einfache Codebeispiel zeigt, wie Sie das Wasserzeichenbild mithilfe einer REST-API finden und ersetzen. Bitte befolgen Sie die zuvor genannten Schritte, um eine Datei hoch und herunterzuladen.
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;
}
Abschluss
Abschließend haben Sie gelernt, wie Sie das Text oder Bildwasserzeichen aus einem PDF Dokument in der Cloud mit der .NET Watermark REST API unter Verwendung von C# suchen und ersetzen. Darüber hinaus haben Sie gelernt, wie Sie die Dateien programmgesteuert in die Cloud hochladen und dann aus der Cloud herunterladen. Darüber hinaus können Sie in der Dokumentation verschiedene weitere nützliche Funktionen der GroupDocs.Watermark Cloud API kennenlernen. Bei Unklarheiten können Sie sich gerne an den Support wenden.