Znak wodny to nałożony obraz lub tekst używany do wyświetlania w dokumentach do różnych celów. Czasami może być konieczne zastąpienie lub edycja wstawionego znaku wodnego nowym tekstem lub obrazem. W tym artykule skupimy się na znajdowaniu i zastępowaniu tekstu lub obrazów znaku wodnego za pomocą interfejsu API REST.

W tym artykule zostaną omówione następujące tematy:

Interfejs API REST znaku wodnego i zestaw .NET SDK

Rodzina produktów Cloud GroupDocs.Watermark

Do wyszukiwania i zastępowania znaku wodnego będę używał .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. Obecnie zapewnia również pakiet Java SDK dla Cloud API.

GroupDocs.Watermark Cloud SDK dla platformy .NET można zainstalować w projekcie programu Visual Studio z menedżera pakietów NuGet, jak pokazano poniżej:

Znajdź i zamień znak wodny za pomocą Rest API

Możesz także zainstalować pakiet NuGet za pomocą następującego polecenia w konsoli Menedżera pakietów:

Install-Package GroupDocs.Watermark-Cloud

Zanim zaczniesz postępować zgodnie z instrukcjami i dostępnymi przykładami kodu, uzyskaj swój identyfikator klienta i klucz tajny klienta z panelu nawigacyjnego. Dodaj swój identyfikator i klucz tajny w kodzie, jak pokazano poniżej:

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

Znajdź i zamień tekstowy znak wodny za pomocą interfejsu API REST

Możesz znaleźć i zamienić tekst znaku wodnego w dokumentach PDF, wykonując proste czynności wymienione poniżej:

Prześlij dokument PDF

Przede wszystkim prześlij dokument PDF zawierający znak wodny do chmury, korzystając z jednej z następujących metod:

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

W rezultacie plik PDF zostanie przesłany do Cloud Storage i będzie dostępny w sekcji plików Twojego pulpitu nawigacyjnego.

Znajdź i zamień tekstowy znak wodny

Poniższy fragment kodu pokazuje, jak znaleźć i zamienić tekstowy znak wodny z przesłanego pliku PDF przy użyciu interfejsu API REST.

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;
}
Znajdź i zamień tekstowy znak wodny za pomocą interfejsu API REST

Możesz także ustawić czcionkę, rozmiar tekstu, kolory pierwszego planu i tła dla tekstu znaku wodnego, korzystając z następującego przykładowego kodu:

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

Pobierz zaktualizowany plik

Powyższe przykłady kodu zapiszą plik PDF z nowym tekstem lub obrazem znaku wodnego w chmurze. Możesz go pobrać, korzystając z następującego przykładowego kodu:

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

Znajdź i zamień obraz znaku wodnego za pomocą interfejsu API REST

Poniższy prosty przykład kodu pokazuje, jak znaleźć i zamienić obraz znaku wodnego za pomocą interfejsu API REST. Wykonaj czynności wymienione wcześniej, aby przesłać i pobrać plik.

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;
}
Znajdź i zamień obraz znaku wodnego za pomocą interfejsu API REST

Wniosek

Podsumowując, nauczyłeś się, jak wyszukiwać i zastępować tekstowy lub graficzny znak wodny z dokumentu PDF w chmurze za pomocą interfejsu API REST znaku wodnego .NET przy użyciu języka C#. Ponadto nauczyłeś się również, jak programowo przesyłać pliki do chmury, a następnie pobierać je z chmury. Ponadto z dokumentacji można dowiedzieć się wielu innych przydatnych funkcji GroupDocs.Watermark Cloud API. W przypadku jakichkolwiek niejasności skontaktuj się z support.

Zobacz też