Puoi aggiungere un testo o un’immagine come filigrana ai tuoi documenti Word in modo programmatico sul cloud. Le filigrane vengono utilizzate per identificare il creatore del documento o altre informazioni come copyright o logo, ecc. Di solito, la filigrana viene utilizzata sotto forma di immagine sovrapposta, logo, motivo o testo inserito all’interno del documento. In questo articolo imparerai come aggiungere una filigrana ai documenti di Word utilizzando un’API REST in C#.
In questo articolo saranno trattati i seguenti argomenti:
- API REST filigrana e .NET SDK
- Aggiungi filigrana di testo ai documenti di Word utilizzando l’API REST in C#
- Aggiungi la filigrana dell’immagine ai documenti di Word utilizzando l’API REST
API REST filigrana e .NET SDK
Per aggiungere filigrana di testo o immagine ai file DOCX, utilizzerò l’API .NET SDK of GroupDocs.Watermark Cloud. Consente di aggiungere, rimuovere, cercare e sostituire filigrane in modo programmatico da immagini e documenti dei formati di file supportati come PDF, Microsoft Word e Powerpoint. Inoltre, puoi controllare la personalizzazione delle filigrane specificando lo stile del testo, il carattere, la dimensione, il colore o la posizione secondo le tue esigenze. Attualmente fornisce anche Java SDK per l’API Cloud.
È possibile installare GroupDocs.Watermark Cloud nel progetto di Visual Studio da NuGet Package Manager o utilizzando il comando seguente nella console di Package Manager:
Install-Package GroupDocs.Watermark-Cloud
Si prega di ottenere l’ID cliente e il segreto dalla dashboard prima di seguire i passaggi menzionati. Una volta che hai il tuo ID e segreto, aggiungi il codice come mostrato di seguito:
string clientId = "da0c487d-c1c0-45ae-b7bf-43eaf53c5ad5";
string clientSecret = "479db2b01dcb93a3d4d20efb16dea971";
string myStorage = "";
var configuration = new Configuration(clientId, clientSecret);
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";
Aggiungi filigrana di testo ai documenti di Word utilizzando l’API REST in C#
Puoi aggiungere qualsiasi testo come filigrana ai tuoi documenti Word in modo programmatico seguendo i semplici passaggi indicati di seguito:
- Caricamento the DOCX file to the Cloud
- Aggiungi filigrana di testo a DOCX usando C#
- Scaricamento the watermarked file
Carica il documento
Innanzitutto, carica il documento Word sul Cloud utilizzando l’esempio di codice riportato di seguito:
// inizializza l'API
var fileApi = new FileApi(configuration);
// apri il file
var fileStream = File.Open(@"C:\Files\sample.docx", FileMode.Open);
// creare richiesta di caricamento file
var request = new UploadFileRequest("sample.docx", fileStream, MyStorage);
// caricare un file
fileApi.UploadFile(request);
fileStream.Close();
Di conseguenza, il file DOCX verrà caricato nell’archivio cloud e sarà disponibile nella sezione file della tua dashboard.
Aggiungi filigrana di testo a DOCX usando C#
È possibile aggiungere una filigrana di testo al file DOCX a livello di codice seguendo i passaggi indicati di seguito.
- Crea un’istanza di WatermarkApi
- Crea un’istanza di FileInfo
- Imposta il percorso del file DOCX
- Crea WatermarkOptions e imposta FileInfo
- Crea TextWatermarkOptions
- Imposta il testo, la famiglia di caratteri, la dimensione del carattere e l’allineamento del testo
- Imposta il colore di primo piano del testo della filigrana
- Definire la posizione della filigrana
- Definisci WatermarkDetails e imposta TextWatermarkOptions e Position
- Crea AddRequest con WatermarkOptions
- Ottieni risultati chiamando il metodo WatermarkApi.add().
L’esempio di codice seguente mostra come aggiungere testo come filigrana a un documento di Word usando un’API REST in C#.
// inizializza l'API
var apiInstance = new WatermarkApi(configuration);
// percorso del file di input
var fileInfo = new FileInfo
{
FilePath = "sample.docx"
};
// creare opzioni di filigrana
var options = new WatermarkOptions()
{
FileInfo = fileInfo,
// definire i dettagli della filigrana
WatermarkDetails = new List<WatermarkDetails>
{
new WatermarkDetails
{
// definire filigrana di testo
TextWatermarkOptions = new TextWatermarkOptions
{
Text = "Copyright© 2021",
FontFamilyName = "Arial",
FontSize = 22d,
TextAlignment = "Center",
ForegroundColor = new Color()
{
Name = "Red"
}
},
// impostare la posizione della filigrana
Position = new Position()
{
X = 230.0,
Y = 500.0
}
}
}
};
// creare richiesta di aggiunta
var request = new AddRequest(options);
// aggiungere filigrana
var response = apiInstance.Add(request);
Console.WriteLine("Resultant file path: " + response.DownloadUrl);
Aggiungi filigrana di testo ai documenti di Word utilizzando l’API REST in C#
Scarica il file aggiornato
L’esempio di codice precedente salverà il file Word con una filigrana di testo sul cloud. Puoi scaricarlo utilizzando il seguente esempio di codice:
// inizializza l'API
var fileApi = new FileApi(configuration);
// percorso file predefinito sul cloud
var file = "watermark/added_watermark/sample_docx/sample.docx";
// creare richiesta di file di download
var downloadRequest = new DownloadFileRequest(file, myStorage);
// download file
Stream downloadResponse = fileApi.DownloadFile(downloadRequest);
// salvare il file nella directory di lavoro
using (var fileStream = System.IO.File.Create("C:\\Files\\DownloadedFile.docx"))
{
downloadResponse.Seek(0, SeekOrigin.Begin);
downloadResponse.CopyTo(fileStream);
}
Aggiungi la filigrana dell’immagine ai documenti di Word utilizzando l’API REST
Puoi aggiungere un’immagine o un logo come filigrana ai tuoi documenti Word a livello di codice seguendo i passaggi indicati di seguito.
- Crea un’istanza di WatermarkApi
- Crea un’istanza di FileInfo
- Imposta il percorso del file DOCX
- Crea WatermarkOptions e imposta FileInfo
- Crea ImageWatermarkOptions
- Imposta FilePath di un’immagine PNG con filigrana
- Definire la posizione della filigrana
- Crea dettagli filigrana
- Impostare ImageWatermarkOptions e Position
- Imposta Dettagli filigrana su Elenco
- Crea AddRequest con WatermarkOptions
- Ottieni risultati chiamando il metodo WatermarkApi.add().
L’esempio di codice seguente mostra come aggiungere un’immagine come filigrana a DOCX usando un’API REST in C#. Si prega di seguire i passaggi menzionati in precedenza per caricare e scaricare i file.
// inizializza l'API
var apiInstance = new WatermarkApi(configuration);
// percorso del file di input
var fileInfo = new FileInfo
{
FilePath = "sample.docx"
};
// creare opzioni di filigrana
var options = new WatermarkOptions()
{
FileInfo = fileInfo,
// definire i dettagli della filigrana
WatermarkDetails = new List<WatermarkDetails>
{
new WatermarkDetails
{
// definire la filigrana dell'immagine
ImageWatermarkOptions = new ImageWatermarkOptions()
{
Image = new FileInfo {
FilePath = "logo.png"
}
},
// impostare la posizione della filigrana
Position = new Position()
{
X = 180.0,
Y = 280.0
}
}
}
};
// creare richiesta di aggiunta
var request = new AddRequest(options);
// aggiungere filigrana
var response = apiInstance.Add(request);
Console.WriteLine("Resultant file path: " + response.DownloadUrl);
Aggiungi filigrana immagine ai documenti di Word utilizzando l’API REST in C#
Prova in linea
Prova il seguente strumento Watermark online gratuito, sviluppato utilizzando l’API di cui sopra. https://products.groupdocs.app/watermark/docx
Conclusione
In conclusione, hai imparato come aggiungere filigrana di testo o immagine a un documento Word sul cloud. Hai anche imparato come caricare a livello di codice i file DOCX sul cloud e quindi scaricare il file aggiornato dal cloud. Puoi saperne di più su GroupDocs.Watermark Cloud API dalla documentazione. Forniamo anche una sezione Riferimento API che ti consente di visualizzare e interagire con le nostre API direttamente attraverso il browser. In caso di ambiguità, non esitare a contattare support.