Możesz programowo dodać tekst lub obraz jako znak wodny do dokumentów programu Word w chmurze. Znaki wodne służą do identyfikacji twórcy dokumentu lub innych informacji, takich jak prawa autorskie, logo itp. Zwykle znak wodny jest używany w postaci nałożonego obrazu, logo, wzoru lub tekstu umieszczonego wewnątrz dokumentu. W tym artykule dowiesz się, jak dodać znak wodny do dokumentów programu Word przy użyciu interfejsu API REST w języku C#.
W tym artykule zostaną omówione następujące tematy:
- Interfejs API REST znaku wodnego i zestaw .NET SDK
- Dodaj tekstowy znak wodny do dokumentów programu Word za pomocą interfejsu API REST w języku C#
- Dodaj znak wodny obrazu do dokumentów programu Word za pomocą interfejsu API REST
Znak wodny REST API i .NET SDK
Aby dodać tekst lub obraz znaku wodnego do plików DOCX, użyję .NET SDK z GroupDocs.Watermark Cloud API. Pozwala programowo dodawać, usuwać, wyszukiwać i zastępować znaki wodne z obrazów i dokumentów obsługiwanych formatów plików, takich jak PDF, Microsoft Word i Powerpoint. Ponadto możesz kontrolować dostosowywanie znaków wodnych, określając styl tekstu, czcionkę, rozmiar, kolor lub pozycję zgodnie z własnymi wymaganiami. Obecnie zapewnia również Java SDK dla Cloud API.
Możesz zainstalować GroupDocs.Watermark Cloud w swoim projekcie Visual Studio z Menedżera pakietów NuGet lub za pomocą następującego polecenia w konsoli Menedżera pakietów:
Install-Package GroupDocs.Watermark-Cloud
Przed wykonaniem wspomnianych kroków uzyskaj swój identyfikator klienta i klucz tajny z panelu nawigacyjnego. Po uzyskaniu identyfikatora i tajnego kodu dodaj kod, jak pokazano poniżej:
string clientId = "da0c487d-c1c0-45ae-b7bf-43eaf53c5ad5";
string clientSecret = "479db2b01dcb93a3d4d20efb16dea971";
string myStorage = "";
var configuration = new Configuration(clientId, clientSecret);
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";
Dodaj tekstowy znak wodny do dokumentów programu Word za pomocą interfejsu API REST w języku C#
Możesz programowo dodać dowolny tekst jako znak wodny do dokumentów programu Word, wykonując proste czynności wymienione poniżej:
- Wgrywać the DOCX file to the Cloud
- Dodaj tekstowy znak wodny do DOCX za pomocą C#
- Pobierać the watermarked file
Prześlij dokument
Najpierw prześlij dokument programu Word do chmury, korzystając z przykładowego kodu podanego poniżej:
// zainicjować api
var fileApi = new FileApi(configuration);
// Otwórz plik
var fileStream = File.Open(@"C:\Files\sample.docx", FileMode.Open);
// utwórz żądanie przesłania pliku
var request = new UploadFileRequest("sample.docx", fileStream, MyStorage);
// Przesyłanie pliku
fileApi.UploadFile(request);
fileStream.Close();
W rezultacie plik DOCX zostanie przesłany do magazynu w chmurze i będzie dostępny w sekcji plików Twojego pulpitu nawigacyjnego.
Dodaj tekstowy znak wodny do DOCX za pomocą C#
Możesz programowo dodać tekstowy znak wodny do pliku DOCX, wykonując czynności podane poniżej.
- Utwórz instancję WatermarkApi
- Utwórz instancję FileInfo
- Ustaw ścieżkę pliku DOCX
- Utwórz WatermarkOptions i ustaw FileInfo
- Utwórz TextWatermarkOptions
- Ustaw tekst, rodzinę czcionek, rozmiar czcionki i wyrównanie tekstu
- Ustaw kolor pierwszego planu tekstu znaku wodnego
- Zdefiniuj położenie znaku wodnego
- Zdefiniuj WatermarkDetails i ustaw TextWatermarkOptions i Position
- Utwórz AddRequest za pomocą WatermarkOptions
- Uzyskaj wyniki, wywołując metodę WatermarkApi.add().
Poniższy przykładowy kod pokazuje, jak dodać tekst jako znak wodny do dokumentu programu Word przy użyciu interfejsu API REST w języku C#.
// zainicjować api
var apiInstance = new WatermarkApi(configuration);
// ścieżka pliku wejściowego
var fileInfo = new FileInfo
{
FilePath = "sample.docx"
};
// utwórz opcje znaku wodnego
var options = new WatermarkOptions()
{
FileInfo = fileInfo,
// zdefiniuj szczegóły znaku wodnego
WatermarkDetails = new List<WatermarkDetails>
{
new WatermarkDetails
{
// zdefiniuj tekstowy znak wodny
TextWatermarkOptions = new TextWatermarkOptions
{
Text = "Copyright© 2021",
FontFamilyName = "Arial",
FontSize = 22d,
TextAlignment = "Center",
ForegroundColor = new Color()
{
Name = "Red"
}
},
// ustaw pozycję znaku wodnego
Position = new Position()
{
X = 230.0,
Y = 500.0
}
}
}
};
// utwórz żądanie dodania
var request = new AddRequest(options);
// Dodaj znak wodny
var response = apiInstance.Add(request);
Console.WriteLine("Resultant file path: " + response.DownloadUrl);
Dodaj tekstowy znak wodny do dokumentów programu Word za pomocą interfejsu API REST w języku C#
Pobierz zaktualizowany plik
Powyższy przykładowy kod zapisze plik Word z tekstowym znakiem wodnym w chmurze. Możesz go pobrać, korzystając z następującego przykładowego kodu:
// zainicjować api
var fileApi = new FileApi(configuration);
// domyślna ścieżka pliku w chmurze
var file = "watermark/added_watermark/sample_docx/sample.docx";
// utwórz żądanie pobrania pliku
var downloadRequest = new DownloadFileRequest(file, myStorage);
// pobieranie pliku
Stream downloadResponse = fileApi.DownloadFile(downloadRequest);
// zapisz plik w katalogu roboczym
using (var fileStream = System.IO.File.Create("C:\\Files\\DownloadedFile.docx"))
{
downloadResponse.Seek(0, SeekOrigin.Begin);
downloadResponse.CopyTo(fileStream);
}
Dodaj znak wodny obrazu do dokumentów programu Word za pomocą interfejsu API REST
Możesz programowo dodać obraz lub logo jako znak wodny do dokumentów programu Word, wykonując czynności podane poniżej.
- Utwórz instancję WatermarkApi
- Utwórz instancję FileInfo
- Ustaw ścieżkę pliku DOCX
- Utwórz WatermarkOptions i ustaw FileInfo
- Utwórz ImageWatermarkOptions
- Ustaw FilePath obrazu PNG na znak wodny
- Zdefiniuj położenie znaku wodnego
- Utwórz szczegóły znaku wodnego
- Ustaw ImageWatermarkOptions i Position
- Ustaw WatermarkDetails na List
- Utwórz AddRequest za pomocą WatermarkOptions
- Uzyskaj wyniki, wywołując metodę WatermarkApi.add().
Poniższy przykładowy kod pokazuje, jak dodać obraz jako znak wodny do DOCX przy użyciu interfejsu API REST w języku C#. Wykonaj czynności wymienione wcześniej, aby przesłać i pobrać pliki.
// zainicjować api
var apiInstance = new WatermarkApi(configuration);
// ścieżka pliku wejściowego
var fileInfo = new FileInfo
{
FilePath = "sample.docx"
};
// utwórz opcje znaku wodnego
var options = new WatermarkOptions()
{
FileInfo = fileInfo,
// zdefiniuj szczegóły znaku wodnego
WatermarkDetails = new List<WatermarkDetails>
{
new WatermarkDetails
{
// zdefiniuj znak wodny obrazu
ImageWatermarkOptions = new ImageWatermarkOptions()
{
Image = new FileInfo {
FilePath = "logo.png"
}
},
// ustaw pozycję znaku wodnego
Position = new Position()
{
X = 180.0,
Y = 280.0
}
}
}
};
// utwórz żądanie dodania
var request = new AddRequest(options);
// Dodaj znak wodny
var response = apiInstance.Add(request);
Console.WriteLine("Resultant file path: " + response.DownloadUrl);
Dodaj znak wodny obrazu do dokumentów programu Word za pomocą interfejsu API REST w języku C#
Wypróbuj online
Wypróbuj następujące bezpłatne narzędzie do znaku wodnego online, które zostało opracowane przy użyciu powyższego interfejsu API. https://products.groupdocs.app/watermark/docx
Wniosek
Podsumowując, nauczyłeś się dodawać tekst lub znak wodny do dokumentu Word w chmurze. Nauczyłeś się również, jak programowo przesłać pliki DOCX do chmury, a następnie pobrać zaktualizowany plik z chmury. Możesz dowiedzieć się więcej o GroupDocs.Watermark Cloud API z dokumentacji. Udostępniamy również sekcję Informacje o interfejsach API, która umożliwia wizualizację naszych interfejsów API i interakcję z nimi bezpośrednio w przeglądarce. W przypadku jakichkolwiek niejasności skontaktuj się z support.