Přidat vodoznak do listu Excel pomocí C#

Již jsme diskutovali o způsobech vodoznaku různých dokumentů, obrázků a prezentací. Dnes budeme diskutovat o tom, jak přidat vodoznak do sešitu aplikace Excel různými způsoby pomocí C# s aplikací .NET.

Níže jsou uvedena následující témata:

.NET API pro vodoznakové listy Excel

GroupDocs.Watermark poskytuje rozhraní .NET API pro dokumenty a obrázky různých formátů souborů. Použijeme GroupDocs.Watermark for .NET k aplikaci vodoznaků v tabulkách různými způsoby pomocí C#.

DLL nebo instalační program MSI si můžete stáhnout z části ke stažení nebo jej získat z NuGet.

Install-Package GroupDocs.Watermark

Vodoznak Excelové listy pomocí C#

Rozhraní API umožňuje vkládat text do tabulek jako vodoznak s různými úpravami. Níže jsou uvedeny kroky pro přidání vodoznaku do sešitů aplikace Excel pomocí jazyka C# s aplikacemi .NET.

  • Připravte možnosti načítání pro tabulku.
  • Načtěte tabulku pomocí Watermarker.
  • Definujte text a vzhled vodoznaku pomocí TextWatermark.
  • Přidejte textový vodoznak do listu aplikace Excel pomocí metody Add.
  • Uložte výslednou tabulku s vodoznakem pomocí metody Uložit.

Následující ukázka kódu C# použije vodoznak textu na všechny listy sešitu aplikace Excel s otočením a neprůhledností.

/*
 * Přidejte vodoznak na všechny listy sešitu Excel pomocí C#
 */
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
using (Watermarker watermarker = new Watermarker(@"path/spreadsheet.xlsx", loadOptions))
{
    // Přidejte textový vodoznak do listu
    TextWatermark textWatermark = new TextWatermark("DRAFT", new Font("Arial", 100))
    {
        RotateAngle = -45,
        Height = 200,
        Width = 500,
        Opacity = .2,
        ForegroundColor = Color.DarkBlue
    };
    // Přidejte vodoznak a uložte tabulku s vodoznakem.
    watermarker.Add(textWatermark);
    watermarker.Save(@"path/allpages-watermark-spreadsheet.xlsx");
}

Specifický list Excelu s vodoznakem pomocí C#

Podobně můžete vodoznaky použít pouze na jakýkoli konkrétní list namísto jejich použití na všechny listy sešitu. Následující kroky popisují, jak vložit textový vodoznak na konkrétní list sešitu Excel pomocí C#.

  • Připravte si možnosti načítání.
  • Načtěte tabulku pomocí třídy Watermarker.
  • Definujte vzhled a text vodoznaku pomocí třídy TextWatermark.
  • Nastavte index listu tak, aby byl vodoznak aplikován pouze na uvedený list.
  • Přidejte textový vodoznak do listu aplikace Excel pomocí Add mehtod s možnostmi vodoznaku.
  • Uložte výstupní tabulku s vodoznakem pomocí metody Uložit.

Následující fragment kódu aplikuje textový vodoznak pouze na zmíněný list sešitu aplikace Excel.

/*
 * Přidejte vodoznak pouze na zmíněný list Excelového sešitu pomocí C#
 */
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
using (Watermarker watermarker = new Watermarker(@"path/spreadsheet.xlsx", loadOptions))
{
    // Přidejte textový vodoznak do listu
    TextWatermark textWatermark = new TextWatermark("DRAFT", new Font("Arial", 100))
    {
        RotateAngle = -45,
        Height = 200,
        Width = 500,
        Opacity = .2,
        ForegroundColor = Color.DarkBlue
    };
    // Definujte index listu
    SpreadsheetWatermarkShapeOptions textWatermarkOptions = new SpreadsheetWatermarkShapeOptions()
    {
        WorksheetIndex = 1
    };
    // Přidejte vodoznak a uložte tabulku s vodoznakem.    
    watermarker.Add(textWatermark, textWatermarkOptions);
    watermarker.Save(@"path/onepage-watermark-spreadsheet.xlsx");
}

Vodoznak Excelové listy jako pozadí pomocí C#

Stejně tak můžeme přidat vodoznaky jako pozadí tabulky. Dojde k malé změně oproti výše uvedeným technikám aplikace vodoznaků. Následují kroky, které umožňují vložení textového vodoznaku na pozadí do tabulky Excel pomocí C#.

  • Připravte si možnosti načítání pro načítání tabulky.
  • Načtěte tabulku pomocí Watermarker.
  • Definujte text a vzhled vodoznaku (otočení, polohu, rozměry, krytí, barvu a další) pomocí TextWatermark.
  • Nastavte možnosti vodoznaku na pozadí získáním obsahu a nastavením rozměrů.
  • Nastavte index listu pro použití vodoznaku. (Volitelný)
  • Přidejte vodoznak do tabulky pomocí Add mehtod.
  • Uložte tabulku s vodoznakem pomocí metody Uložit.

Následující ukázka kódu ukazuje, jak přidat vodoznak na pozadí do tabulky aplikace Excel pomocí jazyka C# v aplikaci .NET.

/*
 * Přidat vodoznak jako pozadí do sešitu Excel pomocí C#
 */
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
using (Watermarker watermarker = new Watermarker(@"path/spreadsheet.xlsx", loadOptions))
{
    // Definujte vzhled vodoznaku
    TextWatermark textWatermark = new TextWatermark("DRAFT", new Font("Arial", 100))
    {
        RotateAngle = -45,
        X = 200,
        Y = 200,
        Height = 200,
        Width = 500,
        Opacity = .2,
        ForegroundColor = Color.DarkBlue
    };
    // Získejte rozměry obsahu tabulky
    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;

    // Přidejte vodoznak a uložte tabulku s vodoznakem.
    watermarker.Add(textWatermark, options);
    watermarker.Save(@"path/background-watermark-spreadsheet.xlsx");
}
Vodoznak Listy Excelu programově

Získejte bezplatnou licenci API

Můžete získat bezplatnou dočasnou licenci, abyste mohli používat API bez omezení hodnocení.

Závěr

Abych to shrnul, diskutovali jsme o různých způsobech, jak přidat vodoznak do listů aplikace Excel pomocí C#. Nejprve jsme do všech listů excelového sešitu přidali textové vodoznaky. Poté jsme vodoznak aplikovali pouze na konkrétní list. Nakonec jsme vložili textový vodoznak do sešitu aplikace Excel jako pozadí.

Navštivte produkt dokumentace, kde se dozvíte více o API. V případě dotazů nás kontaktujte prostřednictvím fóra.

Viz také