Водяний знак — це накладене зображення або текст, який використовується для відображення в документах для різних цілей. Іноді може знадобитися замінити або відредагувати вставлений водяний знак новим текстом або зображенням. У цій статті мова піде про те, як знайти та замінити текст або зображення водяних знаків за допомогою REST API.

У цій статті будуть розглянуті такі теми:

Водяний знак REST API та .NET SDK

Сімейство продуктів GroupDocs.Watermark Cloud

Для пошуку та заміни водяних знаків я буду використовувати API .NET SDK GroupDocs.Watermark Cloud. Він дозволяє програмно додавати, видаляти, шукати та замінювати водяні знаки на зображеннях і документах підтримуваних форматів. Наразі він також надає Java SDK, а також для Cloud API.

GroupDocs.Watermark Cloud SDK для .NET можна встановити у ваш проект Visual Studio з менеджера пакетів NuGet, як показано нижче:

Знайдіть і замініть водяний знак за допомогою Rest API

Ви також можете встановити пакет NuGet за допомогою такої команди в консолі диспетчера пакетів:

Install-Package GroupDocs.Watermark-Cloud

Будь ласка, отримайте свій ідентифікатор клієнта та секрет клієнта з інформаційної панелі, перш ніж почати виконувати кроки та доступні приклади коду. Додайте свій ідентифікатор і секрет у код, як показано нижче:

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);

Знайдіть і замініть текстовий водяний знак за допомогою REST API

Ви можете знайти та замінити текст водяного знака у своїх PDF-документах, виконавши прості дії, наведені нижче:

Завантажте PDF-документ

Перш за все, завантажте PDF-документ із водяним знаком у хмару за допомогою будь-якого з наведених нижче методів.

  • Використання інформаційної панелі
  • Завантажте файл за допомогою Upload File API із браузера
  • Завантажте програмним способом, використовуючи наведений нижче приклад коду:
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();
}

У результаті PDF-файл буде завантажено в хмарне сховище та доступний у розділі файлів вашої інформаційної панелі.

Пошук і заміна текстового водяного знака

У наведеному нижче фрагменті коду показано, як знайти та замінити текстовий водяний знак у завантаженому PDF-файлі за допомогою REST API.

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;
}
Знайдіть і замініть текстовий водяний знак за допомогою REST API

Ви також можете встановити шрифт, розмір тексту, кольори переднього плану та фону для тексту водяного знака, використовуючи такий зразок коду:

ReplaceTextOptions = new ReplaceTextOptions
{
    Text = "Confidential",
    FontFamily = "Arial",
    Size = 20d,
    ForegroundColor = new Color { A = 0, R = 0, G = 100, B = 0 }
}

Завантажте оновлений файл

Наведені вище зразки коду збережуть PDF-файл із новим текстом або зображенням водяного знака в хмарі. Ви можете завантажити його за допомогою наступного зразка коду:

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);
}

Знайдіть і замініть зображення водяного знака за допомогою REST API

Наведений нижче простий приклад коду демонструє, як знайти та замінити зображення водяного знака за допомогою REST API. Будь ласка, виконайте кроки, згадані раніше, щоб завантажити та завантажити файл.

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;
}
Знайдіть і замініть зображення водяного знака за допомогою REST API

Висновок

Підсумовуючи, ви дізналися, як шукати та замінювати водяний знак тексту чи зображення з документа PDF у хмарі за допомогою .NET Watermark REST API за допомогою C#. Крім того, ви також дізналися, як програмно завантажувати файли в хмару, а потім завантажувати їх із хмари. Крім того, ви можете дізнатися про інші корисні функції GroupDocs.Watermark Cloud API з документації. У разі будь-якої неясності зверніться до служби підтримки.

Дивись також