Aggiungi filigrana al foglio Excel usando C#

Abbiamo già discusso dei modi per applicare il watermark a diversi documenti, immagini e presentazioni. Oggi parleremo di come aggiungere una filigrana a una cartella di lavoro di Excel in diversi modi usando C# con l’applicazione .NET.

Di seguito vengono trattati i seguenti argomenti:

API .NET per filigranare fogli Excel

GroupDocs.Watermark fornisce l’API .NET per documenti e immagini di vari formati di file. Useremo GroupDocs.Watermark for .NET per applicare filigrane nei fogli di calcolo in modi diversi usando C#.

Puoi scaricare le DLL o il programma di installazione MSI dalla sezione download o scaricarlo da NuGet.

Install-Package GroupDocs.Watermark

Filigrana fogli Excel usando C#

L’API consente di inserire testo nei fogli di calcolo come filigrana con diverse personalizzazioni. Di seguito sono riportati i passaggi per aggiungere una filigrana alle cartelle di lavoro di Excel usando C# con le applicazioni .NET.

  • Prepara le opzioni di caricamento per il foglio di calcolo.
  • Carica il foglio di calcolo usando Watermarker.
  • Definisci il testo e l’aspetto della filigrana usando TextWatermark.
  • Aggiungi la filigrana di testo al foglio di lavoro di Excel usando Aggiungi mehtod.
  • Salva il foglio di calcolo risultante con filigrana utilizzando il metodo Salva.

L’esempio di codice C# seguente applica la filigrana di testo a tutti i fogli della cartella di lavoro di Excel con rotazione e opacità.

/*
 * Aggiungi filigrana a tutti i fogli della cartella di lavoro di Excel usando C#
 */
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
using (Watermarker watermarker = new Watermarker(@"path/spreadsheet.xlsx", loadOptions))
{
    // Aggiungi filigrana di testo al foglio di lavoro
    TextWatermark textWatermark = new TextWatermark("DRAFT", new Font("Arial", 100))
    {
        RotateAngle = -45,
        Height = 200,
        Width = 500,
        Opacity = .2,
        ForegroundColor = Color.DarkBlue
    };
    // Aggiungi filigrana e salva il foglio di calcolo con filigrana.
    watermarker.Add(textWatermark);
    watermarker.Save(@"path/allpages-watermark-spreadsheet.xlsx");
}

Foglio Excel specifico per filigrana utilizzando C#

Allo stesso modo, puoi applicare filigrane solo a qualsiasi foglio specifico invece di applicarle a tutti i fogli della cartella di lavoro. I passaggi seguenti guidano su come inserire una filigrana di testo nel foglio specifico della cartella di lavoro di Excel usando C#.

  • Prepara le opzioni di caricamento.
  • Carica il foglio di calcolo usando la classe Watermarker.
  • Definisci l’aspetto e il testo della filigrana utilizzando la classe TextWatermark.
  • Imposta l’indice del foglio di lavoro in modo che la filigrana venga applicata solo al foglio menzionato.
  • Aggiungi la filigrana di testo al foglio di lavoro di Excel utilizzando il metodo Aggiungi con le opzioni di filigrana.
  • Salva il foglio di calcolo di output con la filigrana utilizzando il metodo Salva.

Il frammento di codice seguente applica la filigrana di testo solo al foglio menzionato della cartella di lavoro di Excel.

/*
 * Aggiungi filigrana solo al foglio menzionato della cartella di lavoro di Excel usando C#
 */
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
using (Watermarker watermarker = new Watermarker(@"path/spreadsheet.xlsx", loadOptions))
{
    // Aggiungi filigrana di testo al foglio di lavoro
    TextWatermark textWatermark = new TextWatermark("DRAFT", new Font("Arial", 100))
    {
        RotateAngle = -45,
        Height = 200,
        Width = 500,
        Opacity = .2,
        ForegroundColor = Color.DarkBlue
    };
    // Definire l'indice del foglio di lavoro
    SpreadsheetWatermarkShapeOptions textWatermarkOptions = new SpreadsheetWatermarkShapeOptions()
    {
        WorksheetIndex = 1
    };
    // Aggiungi filigrana e salva il foglio di calcolo con filigrana.    
    watermarker.Add(textWatermark, textWatermarkOptions);
    watermarker.Save(@"path/onepage-watermark-spreadsheet.xlsx");
}

Filigrana fogli Excel come sfondo usando C#

Allo stesso modo, possiamo anche aggiungere filigrane come sfondo del foglio di calcolo. Ci sarà un piccolo cambiamento rispetto alle tecniche di applicazione delle filigrane di cui sopra. Di seguito sono riportati i passaggi che consentono di inserire la filigrana del testo di sfondo nel foglio di calcolo di Excel utilizzando C#.

  • Prepara le opzioni di caricamento per il caricamento del foglio di calcolo.
  • Carica il foglio di calcolo usando Watermarker.
  • Definisci il testo e l’aspetto della filigrana (rotazione, posizione, dimensioni, opacità, colore e altro) utilizzando TextWatermark.
  • Imposta le opzioni di filigrana di sfondo ottenendo il contenuto e impostando le dimensioni.
  • Imposta l’indice del foglio di lavoro per applicare la filigrana. (Opzionale)
  • Aggiungi la filigrana al foglio di calcolo usando Aggiungi mehtod.
  • Salva il foglio di calcolo con la filigrana utilizzando il metodo Salva.

L’esempio di codice seguente mostra come aggiungere una filigrana in background a un foglio di calcolo di Excel usando C# all’interno dell’applicazione .NET.

/*
 * Aggiungi filigrana come sfondo alla cartella di lavoro di Excel usando C#
 */
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
using (Watermarker watermarker = new Watermarker(@"path/spreadsheet.xlsx", loadOptions))
{
    // Definisci l'aspetto della filigrana
    TextWatermark textWatermark = new TextWatermark("DRAFT", new Font("Arial", 100))
    {
        RotateAngle = -45,
        X = 200,
        Y = 200,
        Height = 200,
        Width = 500,
        Opacity = .2,
        ForegroundColor = Color.DarkBlue
    };
    // Ottieni le dimensioni del contenuto del foglio di calcolo
    SpreadsheetContent content = watermarker.GetContent<SpreadsheetContent>();
    SpreadsheetBackgroundWatermarkOptions options = new SpreadsheetBackgroundWatermarkOptions();
    options.BackgroundWidth = content.Worksheets[0].ContentAreaWidthPx; /* set background width */
    options.BackgroundHeight = content.Worksheets[0].ContentAreaHeightPx; /* set background height */
    options.WorksheetIndex = 0;

    // Aggiungi filigrana e salva il foglio di calcolo con filigrana.
    watermarker.Add(textWatermark, options);
    watermarker.Save(@"path/background-watermark-spreadsheet.xlsx");
}
Filigrana fogli Excel in modo programmatico

Ottieni una licenza API gratuita

Puoi ottenere una licenza temporanea gratuita per utilizzare l’API senza i limiti di valutazione.

Conclusione

Per riassumere, abbiamo discusso diversi modi per aggiungere filigrana ai fogli Excel usando C#. Innanzitutto, abbiamo aggiunto filigrane di testo a tutti i fogli della cartella di lavoro di Excel. Quindi abbiamo applicato la filigrana solo al foglio specifico. Infine, abbiamo inserito la filigrana basata su testo nella cartella di lavoro di Excel come sfondo.

Visita la documentazione del prodotto per saperne di più sull’API. Per domande, contattaci tramite il forum.

Guarda anche