Ви можете програмно додати текст або зображення як водяний знак до своїх документів Word у хмарі. Водяні знаки використовуються для ідентифікації автора документа або іншої інформації, наприклад авторського права чи логотипу тощо. Зазвичай водяний знак використовується у вигляді накладеного зображення, логотипу, візерунка або тексту, розміщеного всередині документа. У цій статті ви дізнаєтесь, як додати водяний знак до документів Word за допомогою REST API у C#.
У цій статті будуть розглянуті такі теми:
- Водяний знак REST API та .NET SDK
- Додайте текстовий водяний знак до документів Word за допомогою REST API у C#
- Додайте водяний знак зображення до документів Word за допомогою REST API
Водяний знак REST API та .NET SDK
Для додавання текстових або графічних водяних знаків до файлів DOCX я буду використовувати API .NET SDK GroupDocs.Watermark Cloud. Він дозволяє програмним шляхом додавати, видаляти, шукати та замінювати водяні знаки на зображеннях і документах підтримуваних форматів файлів, таких як PDF, Microsoft Word і Powerpoint. Крім того, ви можете керувати налаштуванням водяних знаків, вказавши стиль тексту, шрифт, розмір, колір або положення відповідно до ваших вимог. Наразі він також надає Java SDK для Cloud API.
Ви можете встановити GroupDocs.Watermark Cloud у свій проект Visual Studio з диспетчера пакетів NuGet або за допомогою такої команди в консолі диспетчера пакетів:
Install-Package GroupDocs.Watermark-Cloud
Будь ласка, отримайте свій ідентифікатор клієнта та секрет із інформаційної панелі, перш ніж виконувати вказані дії. Отримавши ідентифікатор і секрет, додайте код, як показано нижче:
string clientId = "da0c487d-c1c0-45ae-b7bf-43eaf53c5ad5";
string clientSecret = "479db2b01dcb93a3d4d20efb16dea971";
string myStorage = "";
var configuration = new Configuration(clientId, clientSecret);
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";
Додайте текстовий водяний знак до документів Word за допомогою REST API у C#
Ви можете додати будь-який текст як водяний знак до своїх документів Word програмним шляхом, виконавши прості кроки, наведені нижче:
- Завантажити the DOCX file to the Cloud
- Додайте текстовий водяний знак до DOCX за допомогою C#
- Завантажити the watermarked file
Завантажте документ
По-перше, завантажте документ Word у хмару, використовуючи наведений нижче приклад коду:
// ініціалізувати api
var fileApi = new FileApi(configuration);
// відкрити файл
var fileStream = File.Open(@"C:\Files\sample.docx", FileMode.Open);
// створити запит на завантаження файлу
var request = new UploadFileRequest("sample.docx", fileStream, MyStorage);
// завантажити файл
fileApi.UploadFile(request);
fileStream.Close();
У результаті файл DOCX буде завантажено в хмарне сховище та доступний у розділі файлів вашої інформаційної панелі.
Додайте текстовий водяний знак до DOCX за допомогою C#
Ви можете програмно додати текстовий водяний знак до файлу DOCX, виконавши наведені нижче дії.
- Створіть екземпляр WatermarkApi
- Створіть екземпляр FileInfo
- Встановіть шлях до файлу DOCX
- Створіть WatermarkOptions і встановіть FileInfo
- Створіть TextWatermarkOptions
- Установіть текст, сімейство шрифтів, розмір шрифту та вирівнювання тексту
- Встановити колір переднього плану для тексту водяного знака
- Визначте положення водяного знака
- Визначте WatermarkDetails і встановіть TextWatermarkOptions і Position
- Створіть AddRequest із WatermarkOptions
- Отримайте результати, викликавши метод WatermarkApi.add().
У наведеному нижче прикладі коду показано, як додати текст як водяний знак до документа Word за допомогою REST API у C#.
// ініціалізувати api
var apiInstance = new WatermarkApi(configuration);
// шлях до вхідного файлу
var fileInfo = new FileInfo
{
FilePath = "sample.docx"
};
// створити параметри водяного знака
var options = new WatermarkOptions()
{
FileInfo = fileInfo,
// визначити деталі водяного знака
WatermarkDetails = new List<WatermarkDetails>
{
new WatermarkDetails
{
// визначити текстовий водяний знак
TextWatermarkOptions = new TextWatermarkOptions
{
Text = "Copyright© 2021",
FontFamilyName = "Arial",
FontSize = 22d,
TextAlignment = "Center",
ForegroundColor = new Color()
{
Name = "Red"
}
},
// встановити положення водяного знака
Position = new Position()
{
X = 230.0,
Y = 500.0
}
}
}
};
// створити запит на додавання
var request = new AddRequest(options);
// додати водяний знак
var response = apiInstance.Add(request);
Console.WriteLine("Resultant file path: " + response.DownloadUrl);
Додайте текстовий водяний знак до документів Word за допомогою REST API у C#
Завантажте оновлений файл
Наведений вище приклад коду збереже файл Word із текстовим водяним знаком у хмарі. Ви можете завантажити його за допомогою наступного зразка коду:
// ініціалізувати api
var fileApi = new FileApi(configuration);
// типовий шлях до файлу в хмарі
var file = "watermark/added_watermark/sample_docx/sample.docx";
// створити запит на завантаження файлу
var downloadRequest = new DownloadFileRequest(file, myStorage);
// завантажити файл
Stream downloadResponse = fileApi.DownloadFile(downloadRequest);
// зберегти файл у робочому каталозі
using (var fileStream = System.IO.File.Create("C:\\Files\\DownloadedFile.docx"))
{
downloadResponse.Seek(0, SeekOrigin.Begin);
downloadResponse.CopyTo(fileStream);
}
Додайте водяний знак зображення до документів Word за допомогою REST API
Ви можете програмно додати зображення або логотип як водяний знак до документів Word, виконавши наведені нижче дії.
- Створіть екземпляр WatermarkApi
- Створіть екземпляр FileInfo
- Встановіть шлях до файлу DOCX
- Створіть WatermarkOptions і встановіть FileInfo
- Параметри створення зображення водяного знака
- Установіть FilePath зображення PNG для водяного знака
- Визначте положення водяного знака
- Створити WatermarkDetails
- Встановіть параметри зображення водяного знака та положення
- Встановіть WatermarkDetails на List
- Створіть AddRequest із WatermarkOptions
- Отримайте результати, викликавши метод WatermarkApi.add().
У наведеному нижче прикладі коду показано, як додати зображення як водяний знак до DOCX за допомогою REST API у C#. Будь ласка, виконайте кроки, згадані раніше, щоб завантажити та завантажити файли.
// ініціалізувати api
var apiInstance = new WatermarkApi(configuration);
// шлях до вхідного файлу
var fileInfo = new FileInfo
{
FilePath = "sample.docx"
};
// створити параметри водяного знака
var options = new WatermarkOptions()
{
FileInfo = fileInfo,
// визначити деталі водяного знака
WatermarkDetails = new List<WatermarkDetails>
{
new WatermarkDetails
{
// визначити водяний знак зображення
ImageWatermarkOptions = new ImageWatermarkOptions()
{
Image = new FileInfo {
FilePath = "logo.png"
}
},
// встановити положення водяного знака
Position = new Position()
{
X = 180.0,
Y = 280.0
}
}
}
};
// створити запит на додавання
var request = new AddRequest(options);
// додати водяний знак
var response = apiInstance.Add(request);
Console.WriteLine("Resultant file path: " + response.DownloadUrl);
Додайте водяний знак зображення до документів Word за допомогою REST API у C#
Спробуйте онлайн
Будь ласка, спробуйте наведений нижче безкоштовний онлайн-інструмент водяних знаків, розроблений за допомогою вищезазначеного API. https://products.groupdocs.app/watermark/docx
Висновок
Підсумовуючи, ви дізналися, як додати водяний знак із текстом або зображенням до документа Word у хмарі. Ви також дізналися, як програмно завантажити файли DOCX у хмару, а потім завантажити оновлений файл із хмари. Ви можете дізнатися більше про GroupDocs.Watermark Cloud API з документації. Ми також надаємо розділ API Reference, який дозволяє візуалізувати наші API та взаємодіяти з ними безпосередньо через браузер. У разі будь-якої неясності зверніться до служби підтримки 13.