Sie können Ihren Word Dokumenten programmgesteuert in der Cloud einen Text oder ein Bild als Wasserzeichen hinzufügen. Die Wasserzeichen werden verwendet, um den Ersteller des Dokuments oder andere Informationen wie Urheberrecht oder Logo usw. zu identifizieren. Normalerweise wird das Wasserzeichen in Form eines überlagerten Bildes, Logos, Musters oder Textes im Dokument verwendet. In diesem Artikel erfahren Sie, wie Sie mithilfe einer REST-API in C# ein Wasserzeichen zu Word Dokumenten hinzufügen.
Die folgenden Themen sollen in diesem Artikel behandelt werden:
- Wasserzeichen-REST-API und .NET SDK
- Hinzufügen von Textwasserzeichen zu Word Dokumenten mithilfe der REST-API in C#
- Fügen Sie mithilfe der REST-API Bildwasserzeichen zu Word Dokumenten hinzu
Wasserzeichen-REST-API und .NET SDK
Zum Hinzufügen von Text oder Bildwasserzeichen zu DOCX Dateien verwende ich die .NET SDK of GroupDocs.Watermark Cloud API. Es ermöglicht Ihnen, Wasserzeichen in Bildern und Dokumenten der unterstützten Dateiformate wie PDF, Microsoft Word und Powerpoint programmgesteuert hinzuzufügen, zu entfernen, zu suchen und zu ersetzen. Darüber hinaus können Sie die Anpassung von Wasserzeichen steuern, indem Sie den Textstil, die Schriftart, die Größe, die Farbe oder die Position entsprechend Ihren Anforderungen festlegen. Derzeit wird auch Java SDK für die Cloud API bereitgestellt.
Sie können GroupDocs.Watermark Cloud über den Paket-Manager NuGet oder mit dem folgenden Befehl in der Paket-Manager-Konsole in Ihrem Visual Studio-Projekt installieren:
Install-Package GroupDocs.Watermark-Cloud
Bitte rufen Sie Ihre Kunden-ID und Ihr Geheimnis vom Dashboard ab, bevor Sie die genannten Schritte ausführen. Sobald Sie Ihre ID und Ihr Geheimnis haben, fügen Sie den Code wie unten gezeigt ein:
string clientId = "da0c487d-c1c0-45ae-b7bf-43eaf53c5ad5";
string clientSecret = "479db2b01dcb93a3d4d20efb16dea971";
string myStorage = "";
var configuration = new Configuration(clientId, clientSecret);
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";
Hinzufügen von Textwasserzeichen zu Word Dokumenten mithilfe der REST-API in C#
Sie können Ihren Word Dokumenten programmgesteuert beliebigen Text als Wasserzeichen hinzufügen, indem Sie die folgenden einfachen Schritte ausführen:
- Hochladen the DOCX file to the Cloud
- Textwasserzeichen zu DOCX mit C# hinzufügen
- Herunterladen the watermarked file
Laden Sie das Dokument hoch
Laden Sie zunächst das Word Dokument mithilfe des unten angegebenen Codebeispiels in die Cloud hoch:
// API initialisieren
var fileApi = new FileApi(configuration);
// Datei öffnen
var fileStream = File.Open(@"C:\Files\sample.docx", FileMode.Open);
// Datei-Upload-Anfrage erstellen
var request = new UploadFileRequest("sample.docx", fileStream, MyStorage);
// Datei hochladen
fileApi.UploadFile(request);
fileStream.Close();
Als Ergebnis wird die DOCX-Datei in den Cloud-Speicher hochgeladen und ist im Dateienbereich Ihres Dashboards verfügbar.
Fügen Sie mit C# Textwasserzeichen zu DOCX hinzu
Sie können der DOCX-Datei programmgesteuert ein Textwasserzeichen hinzufügen, indem Sie die folgenden Schritte ausführen.
- Erstellen Sie eine Instanz der WatermarkApi
- Erstellen Sie eine Instanz der FileInfo
- Legen Sie den DOCX-Dateipfad fest
- Erstellen Sie WatermarkOptions und legen Sie FileInfo fest
- Erstellen Sie TextWatermarkOptions
- Legen Sie Text, Schriftfamilie, Schriftgröße und die Textausrichtung fest
- Legen Sie die Vordergrundfarbe des Wasserzeichentextes fest
- Definieren Sie die Position des Wasserzeichens
- Definieren Sie WatermarkDetails und legen Sie TextWatermarkOptions und Position fest
- Erstellen Sie AddRequest mit WatermarkOptions
- Erhalten Sie Ergebnisse, indem Sie die Methode WatermarkApi.add() aufrufen
Das folgende Codebeispiel zeigt, wie Sie mithilfe einer REST-API in C# Text als Wasserzeichen zu einem Word Dokument hinzufügen.
// API initialisieren
var apiInstance = new WatermarkApi(configuration);
// Eingabedateipfad
var fileInfo = new FileInfo
{
FilePath = "sample.docx"
};
// Erstellen Sie Wasserzeichenoptionen
var options = new WatermarkOptions()
{
FileInfo = fileInfo,
// Definieren Sie Wasserzeichendetails
WatermarkDetails = new List<WatermarkDetails>
{
new WatermarkDetails
{
// Textwasserzeichen definieren
TextWatermarkOptions = new TextWatermarkOptions
{
Text = "Copyright© 2021",
FontFamilyName = "Arial",
FontSize = 22d,
TextAlignment = "Center",
ForegroundColor = new Color()
{
Name = "Red"
}
},
// Legen Sie die Position des Wasserzeichens fest
Position = new Position()
{
X = 230.0,
Y = 500.0
}
}
}
};
// Hinzufügen-Anfrage erstellen
var request = new AddRequest(options);
// Wasserzeichen hinzufügen
var response = apiInstance.Add(request);
Console.WriteLine("Resultant file path: " + response.DownloadUrl);
Hinzufügen von Textwasserzeichen zu Word Dokumenten mithilfe der REST-API in C#
Laden Sie die aktualisierte Datei herunter
Das obige Codebeispiel speichert die Word-Datei mit einem Textwasserzeichen in der Cloud. Sie können es mit dem folgenden Codebeispiel herunterladen:
// API initialisieren
var fileApi = new FileApi(configuration);
// Standarddateipfad in der Cloud
var file = "watermark/added_watermark/sample_docx/sample.docx";
// Download-Dateianfrage erstellen
var downloadRequest = new DownloadFileRequest(file, myStorage);
// Download-Datei
Stream downloadResponse = fileApi.DownloadFile(downloadRequest);
// Datei im Arbeitsverzeichnis speichern
using (var fileStream = System.IO.File.Create("C:\\Files\\DownloadedFile.docx"))
{
downloadResponse.Seek(0, SeekOrigin.Begin);
downloadResponse.CopyTo(fileStream);
}
Fügen Sie mithilfe der REST-API Bildwasserzeichen zu Word Dokumenten hinzu
Sie können Ihren Word Dokumenten programmgesteuert ein Bild oder ein Logo als Wasserzeichen hinzufügen, indem Sie die folgenden Schritte ausführen.
- Erstellen Sie eine Instanz der WatermarkApi
- Erstellen Sie eine Instanz der FileInfo
- Legen Sie den DOCX-Dateipfad fest
- Erstellen Sie WatermarkOptions und legen Sie FileInfo fest
- Erstellen Sie ImageWatermarkOptions
- Legen Sie den Dateipfad eines PNG bilds als Wasserzeichen fest
- Definieren Sie die Position des Wasserzeichens
- Erstellen Sie WatermarkDetails
- Legen Sie ImageWatermarkOptions und Position fest
- Setzen Sie WatermarkDetails auf Liste
- Erstellen Sie AddRequest mit WatermarkOptions
- Erhalten Sie Ergebnisse, indem Sie die Methode WatermarkApi.add() aufrufen
Das folgende Codebeispiel zeigt, wie Sie mithilfe einer REST-API in C# ein Bild als Wasserzeichen zu DOCX hinzufügen. Bitte befolgen Sie die zuvor genannten Schritte, um die Dateien hoch und herunterzuladen.
// API initialisieren
var apiInstance = new WatermarkApi(configuration);
// Eingabedateipfad
var fileInfo = new FileInfo
{
FilePath = "sample.docx"
};
// Erstellen Sie Wasserzeichenoptionen
var options = new WatermarkOptions()
{
FileInfo = fileInfo,
// Definieren Sie Wasserzeichendetails
WatermarkDetails = new List<WatermarkDetails>
{
new WatermarkDetails
{
// Bildwasserzeichen definieren
ImageWatermarkOptions = new ImageWatermarkOptions()
{
Image = new FileInfo {
FilePath = "logo.png"
}
},
// Legen Sie die Position des Wasserzeichens fest
Position = new Position()
{
X = 180.0,
Y = 280.0
}
}
}
};
// Hinzufügen-Anfrage erstellen
var request = new AddRequest(options);
// Wasserzeichen hinzufügen
var response = apiInstance.Add(request);
Console.WriteLine("Resultant file path: " + response.DownloadUrl);
Hinzufügen von Bildwasserzeichen zu Word Dokumenten mithilfe der REST-API in C#
Versuchen Sie es online
Bitte probieren Sie das folgende kostenlose Online-Wasserzeichen-Tool aus, das mit der oben genannten API entwickelt wurde. https://products.groupdocs.app/watermark/docx
Abschluss
Abschließend haben Sie gelernt, wie Sie einem Word Dokument in der Cloud Text oder Bildwasserzeichen hinzufügen. Sie haben außerdem gelernt, wie Sie die DOCX Dateien programmgesteuert in die Cloud hochladen und dann die aktualisierte Datei aus der Cloud herunterladen. Weitere Informationen zur GroupDocs.Watermark Cloud API finden Sie in der Dokumentation. Wir bieten auch einen Abschnitt API-Referenz an, mit dem Sie unsere APIs direkt über den Browser visualisieren und mit ihnen interagieren können. Bei Unklarheiten können Sie sich gerne an den Support wenden.