Una filigrana è un’immagine o un testo sovrapposto utilizzato per essere visualizzato nei documenti per vari scopi. A volte, potrebbe essere necessario sostituire o modificare la filigrana inserita con un nuovo testo o immagine. Questo articolo si concentrerà su come trovare e sostituire il testo o le immagini della filigrana utilizzando un’API REST.

In questo articolo saranno trattati i seguenti argomenti:

API REST filigrana e .NET SDK

Famiglia di prodotti cloud GroupDocs.Watermark

Per la ricerca e la sostituzione della filigrana, utilizzerò l’API .NET SDK of GroupDocs.Watermark Cloud. Ti consente di aggiungere, rimuovere, cercare e sostituire in modo programmatico filigrane da immagini e documenti di formati supportati. Attualmente fornisce anche Java SDK per l’API Cloud.

GroupDocs.Watermark Cloud SDK per .NET può essere installato nel progetto di Visual Studio dal gestore pacchetti NuGet come mostrato di seguito:

Trova e sostituisci filigrana utilizzando un'API Rest

È inoltre possibile installare il pacchetto NuGet utilizzando il seguente comando nella console di Package Manager:

Install-Package GroupDocs.Watermark-Cloud

Ottieni il tuo ID cliente e il tuo segreto cliente dalla dashboard prima di iniziare a seguire i passaggi e gli esempi di codice disponibili. Aggiungi il tuo ID e Segreto nel codice come mostrato di seguito:

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

Trova e sostituisci filigrana di testo utilizzando un’API REST

Puoi trovare e sostituire il testo della filigrana dai tuoi documenti PDF seguendo i semplici passaggi indicati di seguito:

Carica il documento PDF

Prima di tutto, carica il documento PDF contenente la filigrana sul Cloud utilizzando uno dei seguenti metodi:

  • Utilizzo della dashboard
  • Carica il file utilizzando Upload File API dal browser
  • Carica a livello di codice utilizzando l’esempio di codice fornito di seguito:
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();
}

Di conseguenza, il file PDF verrà caricato su Cloud Storage e sarà disponibile nella sezione file della dashboard.

Trova e sostituisci filigrana di testo

Il seguente frammento di codice mostra come trovare e sostituire una filigrana di testo da un file PDF caricato utilizzando un’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;
}
Trova e sostituisci filigrana di testo utilizzando l'API REST

È inoltre possibile impostare il carattere, la dimensione del testo, i colori di primo piano e di sfondo per il testo della filigrana utilizzando il seguente esempio di codice:

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

Scarica il file aggiornato

Gli esempi di codice sopra riportati salveranno il file PDF con un nuovo testo o immagine della filigrana sul cloud. Puoi scaricarlo utilizzando il seguente esempio di codice:

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

Trova e sostituisci l’immagine della filigrana utilizzando un’API REST

Il semplice esempio di codice fornito di seguito mostra come trovare e sostituire l’immagine della filigrana utilizzando un’API REST. Si prega di seguire i passaggi menzionati in precedenza per caricare e scaricare un file.

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;
}
Trova e sostituisci l'immagine della filigrana utilizzando l'API REST

Conclusione

In conclusione, hai imparato come cercare e sostituire la filigrana di testo o immagine da un documento PDF sul cloud con .NET Watermark REST API utilizzando C#. Inoltre, hai anche imparato come caricare in modo programmatico i file sul cloud e poi scaricarli dal cloud. Inoltre, puoi apprendere varie altre utili funzionalità dell’API GroupDocs.Watermark Cloud dalla documentazione. In caso di ambiguità, non esitare a contattare support.

Guarda anche