Un’intestazione è il margine superiore di ogni pagina e un piè di pagina è il margine inferiore di ogni pagina. Intestazioni e piè di pagina sono utili per includere informazioni che vuoi visualizzare su ogni pagina di un documento, come il tuo nome, le date, il titolo del documento, i numeri di pagina o le esclusioni di responsabilità nei documenti. Quando usi MS Word, fornisce le capacità per aggiungere intestazioni e piè di pagina in base a layout predefiniti o ti consente di aggiungere intestazioni e piè di pagina personalizzati. La maggior parte delle intestazioni integrate contiene del testo segnaposto e puoi mantenere il testo segnaposto o sostituirlo con il tuo feed di dati. Inoltre, quando aggiorni le informazioni nella sezione Intestazione o Piè di pagina, il contenuto all’interno del corpo principale del documento è disattivato, il che indica che questi oggetti sono totalmente isolati dal resto del contenuto della pagina e l’operazione che esegui su questi oggetti è specifica per queste aree. In questo articolo, impareremo i passaggi su come aggiungere o aggiornare l’intestazione o il piè di pagina nel documento Word utilizzando l’API REST.

API di elaborazione testi

Aspose.Words Cloud API fornisce le capacità per caricare file MS Word dall’archiviazione Cloud, e consente all’utente di passare il file di input direttamente nel corpo della richiesta e l’API restituisce il file aggiornato nell’oggetto di risposta. Fornisce le funzionalità per leggere, aggiungere, aggiornare o eliminare oggetti Intestazione e Piè di pagina specifici o tutti. Inoltre, puoi anche specificare di eseguire il rendering di intestazioni/piè di pagina diversi per la prima pagina e per le pagine dispari/pari.

Inoltre, l’API consente anche di impostare informazioni di formattazione come le proprietà del font e del paragrafo per il testo dell’intestazione/piè di pagina. Si ottiene anche la leva per inserire numeri di pagina dinamici nella sezione dell’intestazione/piè di pagina. Ultimo ma non meno importante, si può prendere in considerazione l’utilizzo di oggetti tabella per allineare una parte del testo dell’intestazione/piè di pagina al bordo sinistro e l’altra al bordo destro.

Ambito di applicazione dell’articolo

Il nostro Aspose.Words Cloud SDK per .NET ti consente di lavorare con Aspose.Words Cloud REST API in modo rapido e semplice, poiché si occupa di molti dettagli di basso livello riguardanti l’esecuzione di richieste e la gestione delle risposte e ti consente di concentrarti sulla scrittura di codice specifico per i requisiti aziendali. In questo articolo, utilizzeremo Aspose.Words Cloud SDK per .NET in Visual Studio per Mac. Questo post definisce i passaggi per inserire Header Footer in Word Document in cui verrà definita la formattazione personalizzata. Quindi la formattazione del contenuto del Footer in uscita viene aggiornata e le informazioni PageNumber vengono inserite nella posizione in basso a destra. Tutte queste operazioni verranno eseguite nel cloud.

Installazione

Per iniziare, per prima cosa devi installare Visual Studio sul tuo sistema. Crea una soluzione di esempio e aggiungi il riferimento NuGet di Aspose.Words Cloud SDK per .NET. Quindi, per aggiungere un riferimento, fai clic con il pulsante destro del mouse sulla soluzione e seleziona l’opzione di menu Gestisci pacchetti NuGet…. Immetti Aspose.Words-Cloud nel campo di testo di ricerca. Seleziona l’opzione e fai clic sul pulsante Aggiungi pacchetto.

Ora il riferimento Aspose.Words.Cloud.Sdk appare nella soluzione. Ci sono alcuni vantaggi nell’usare le API cloud rispetto alle API on-premise (aspose.com).Il motivo è che non devi tenere traccia e aggiornare manualmente le versioni API e non devi pagare l’intera licenza.

Pannello di controllo di Aspose.Cloud

Basta creare un account su Aspose.Cloud dashboard o registrarsi tramite il proprio account Google o GitHub esistente e iniziare a utilizzare le nostre API Cloud. Un’altra caratteristica sorprendente delle API Cloud è che puoi utilizzarle su qualsiasi piattaforma utilizzando qualsiasi linguaggio supportato.

Come indicato sopra, l’articolo enfatizza le opzioni relative all’aggiunta e all’aggiornamento degli oggetti Header e Footer all’interno dei documenti MS Word. Per motivi di test, abbiamo utilizzato un modello di documento MS Word esistente con il nome Business Letter. Il documento deve essere caricato su Aspose cloud storage e tutte le manipolazioni e l’elaborazione del documento saranno eseguite sul cloud. Una volta completata tutta l’elaborazione, possiamo anche scaricare la copia del file risultante dal cloud storage.

using Aspose.Words.Cloud.Sdk;
using Aspose.Words.Cloud.Sdk.Model;
using Aspose.Words.Cloud.Sdk.Model.Requests;

Ora, per utilizzare le API Aspose.Cloud, devi usare le informazioni App Key e App SID nel tuo codice. Queste chiavi sono composte da cifre alfanumeriche. Si tratta di codici univoci associati al tuo account di abbonamento. Per ottenere questi dettagli, fai clic sulla scheda My Apps su Aspose.Cloud dashboard. Una volta ottenute le chiavi, dobbiamo inizializzare l’oggetto API Aspose.Words.

string MyAppKey = "f6axxxxxxxxxxxxxxxxxx";     // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "478e4827-xxxxx-xxxx-xxxx-xxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
// create an object of WordsApi while passing AppKey and AppSid information
WordsApi wordsApi = new WordsApi(MyAppKey, MyAppSid);

Inserisci oggetto Intestazione

Per aggiungere l’oggetto intestazione all’interno del file MS Word, dobbiamo eseguire le seguenti operazioni in sequenza.

  1. Creiamo un oggetto di InsertHeaderFooterRequest in cui passiamo il tipo HeaderFooterLink come argomento.
  2. Inserire l’oggetto HeaderFooterRequest nell’oggetto WordsApi utilizzando il metodo InsertHeaderFooter (…).
  3. Crea un oggetto Run che contenga informazioni di testo di esempio.
  4. Creiamo l’oggetto InsertRunRequest in cui passiamo il riferimento del paragrafo (SectionPath) nell’oggetto HeaderFooter, in cui è necessario aggiungere il testo Run.
    Quindi chiamare il metodo InsertRun (…) di WordsApi, che aggiunge RunRequest all’oggetto HeaderFooter.

HeaderFooter.TypeEnum può avere uno dei seguenti valori.

string MyAppKey = "xxxxxxxx";    // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "xxxxxxxxx";   // Get AppKey and AppSID from https://dashboard.aspose.cloud/
// crea un oggetto di WordsAPI durante il passaggio delle informazioni AppKey e AppSid
WordsApi wordsApi = new WordsApi(MyAppKey, MyAppSid);

// carica il documento campione sullo storage cloud
wordsApi.UploadFile(new UploadFileRequest(new System.IO.FileStream("/Users/nayyershahbaz/Documents/BusinessLetter.docx", 
    FileMode.Open, FileAccess.Read), "BusinessLetter.docx"));

// Inserisci oggetto intestazione nella prima pagina
var putHeaderFooterRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.InsertHeaderFooterRequest("BusinessLetter.docx", "HeaderFirst", null,null);  
var actual = wordsApi.InsertHeaderFooter(putHeaderFooterRequest);
// Crea un oggetto Run contenente un testo di esempio
var run = new Run { Text = "Aspose.Words Cloud SDK for .NET " };
// aggiungi il testo Run al primo paragrafo del primo oggetto HeaderFooter nella prima sezione del documento Word
var runRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.InsertRunRequest("BusinessLetter.docx", "sections/0/headersfooters/1/paragraphs/0", run);
// Inserisci la richiesta RunRequest nel documento Word
var actual2 = wordsApi.InsertRun(runRequest);

Aggiorna la formattazione del testo dell’intestazione appena inserita

Una volta aggiunto l’oggetto Header, possiamo aggiornare la formattazione del testo del contenuto al suo interno. Per soddisfare questo requisito, dobbiamo eseguire i seguenti passaggi.

  1. Creiamo un oggetto della classe Font, in cui specifichiamo il nome del font, la dimensione e le informazioni sul colore.
  2. Per rendere il testo più presentabile, contrassegnare la proprietà Engrave come True.
  3. Creiamo un oggetto della classe UpdateRunFontRequest a cui passiamo il file di input, Font, SectionPath e runIndex come argomento.
  4. Infine, utilizzare il metodo UpdateRunFont(..) e aggiungere l’oggetto UpdateRunFontRequest all’istanza di WordsApi.
string MyAppKey = "xxxxxxxx";    // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "xxxxxxxxx";   // Get AppKey and AppSID from https://dashboard.aspose.cloud/
// crea un oggetto di WordsAPI durante il passaggio delle informazioni AppKey e AppSid
WordsApi wordsApi = new WordsApi(MyAppKey, MyAppSid);

// carica il documento di esempio sullo storage cloud
wordsApi.UploadFile(new UploadFileRequest(new System.IO.FileStream("/Users/nayyershahbaz/Documents/BusinessLetter.docx", 
    FileMode.Open, FileAccess.Read), "BusinessLetter.docx"));

// Il passo successivo è impostare la formattazione dell'oggetto intestazione
var runIndex = 0;
var fontDto = new Font { Bold = true, Name = "Verdana", Size = 16, Color = new XmlColor { Web = "#e0a50d" } };
//  Imposta la formattazione del testo come Incisa
fontDto.Engrave = true;
// Applica la formattazione al primo paragrafo dell'oggetto HeaderFooter
var documentParagraphRunFontRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.UpdateRunFontRequest("BusinessLetter.docx",
    fontDto, "sections/0/headersfooters/1/paragraphs/0", runIndex);
var actual4 = wordsApi.UpdateRunFont(documentParagraphRunFontRequest);

L’API offre anche la funzionalità di aggiornare la formattazione del contenuto all’interno dell’oggetto Header / Footer esistente. Per soddisfare questo requisito, possiamo usare le righe di codice specificate sopra, ma l’unica differenza è la modifica dell’indice headerfooter a 2. Vedere la seguente riga di codice.

// Apply formatting to first paragraph of HeaderFooter object
var FooterDocumentParagraphRunFontRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.UpdateRunFontRequest("BusinessLetter.docx", 
FooterFontDto, "sections/0/headersfooters/2/paragraphs/0", FooterrunIndex);

Aggiungere informazioni sul numero di pagina nella sezione piè di pagina

I numeri di pagina forniscono informazioni molto utili, come la pagina corrente e il numero totale di pagine in un documento. I seguenti passaggi definiscono come soddisfare i requisiti.

  1. Per prima cosa creiamo un oggetto della classe PageNumber, in cui definiamo l’allineamento del testo, il formato del testo, la posizione in cui visualizzare le informazioni PageNumber e inoltre specifichiamo se PageNumber deve essere visualizzato sulla prima pagina oppure no.
  2. Crea l’oggetto InsertPageNumbersRequest e passa l’oggetto PageNumber come argomento.
  3. Infine, chiama il metodo InsertPageNumbers(..) per aggiungere InsertPageNumbersRequest all’istanza di WordsApi.
string MyAppKey = "xxxxxxxx";    // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "xxxxxxxxx";   // Get AppKey and AppSID from https://dashboard.aspose.cloud/
// crea un oggetto di WordsAPI durante il passaggio delle informazioni AppKey e AppSid
WordsApi wordsApi = new WordsApi(MyAppKey, MyAppSid);

// carica il documento di esempio sullo storage cloud
wordsApi.UploadFile(new UploadFileRequest(new System.IO.FileStream("/Users/nayyershahbaz/Documents/BusinessLetter.docx", 
    FileMode.Open, FileAccess.Read), "BusinessLetter.docx"));

// L'API offre anche la funzionalità di aggiungere dettagli sul numero di pagina nell'oggetto HeaderFooter
// Aggiungere le informazioni sul numero di pagina in basso a destra della pagina
var body = new PageNumber { Alignment = "right", Format = "{PAGE} of {NUMPAGES}", IsTop = false, SetPageNumberOnFirstPage = true };
var insertPageNumbersRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.InsertPageNumbersRequest("BusinessLetter.docx", body);
// Inserire le informazioni di PageNumber all'interno del documento Word
var actual6 = wordsApi.InsertPageNumbers(insertPageNumbersRequest);

Conclusione

In questo articolo, abbiamo appreso i passaggi su come aggiungere un’intestazione o un piè di pagina in un documento Word utilizzando Aspose.Words Cloud SDK per .NET. Si noti che sono disponibili anche Cloud SDK per Java, PHP, Ruby, Python, Go, Swift, C++, Node.Js, Android. Per ulteriori dettagli, visitare Aspose.Words Cloud.

Articoli correlati

Ti consigliamo inoltre di visitare quanto segue per saperne di più su