Dodaj znak wodny do arkusza Excela za pomocą C#

Omówiliśmy już sposoby znakowania wodnego różnych dokumentów, obrazów i prezentacji. Dzisiaj omówimy, jak dodać znak wodny do skoroszytu programu Excel na różne sposoby przy użyciu języka C# z aplikacją .NET.

Poniżej omówiono następujące tematy:

Interfejs API platformy .NET do arkuszy programu Excel ze znakami wodnymi

GroupDocs.Watermark zapewnia interfejs API .NET dla dokumentów i obrazów w różnych formatach plików. Będziemy używać GroupDocs.Watermark for .NET do stosowania znaków wodnych w arkuszach kalkulacyjnych na różne sposoby przy użyciu języka C#.

Możesz pobrać pliki DLL lub instalator MSI z sekcji pobierania lub pobrać go z NuGet.

Install-Package GroupDocs.Watermark

Arkusze programu Excel ze znakami wodnymi przy użyciu języka C#

Interfejs API umożliwia wstawianie tekstu do arkuszy kalkulacyjnych jako znaku wodnego z różnymi dostosowaniami. Poniżej przedstawiono kroki dodawania znaku wodnego do skoroszytów programu Excel przy użyciu języka C# z aplikacjami .NET.

  • Przygotuj opcje ładowania dla arkusza kalkulacyjnego.
  • Załaduj arkusz kalkulacyjny za pomocą Znacznika wodnego.
  • Zdefiniuj tekst i wygląd znaku wodnego za pomocą TextWatermark.
  • Dodaj tekstowy znak wodny do arkusza programu Excel za pomocą metody Dodaj.
  • Wynikowy arkusz kalkulacyjny ze znakiem wodnym zapisz metodą Save.

Poniższy przykładowy kod C# stosuje tekstowy znak wodny do wszystkich arkuszy skoroszytu programu Excel z obrotem i kryciem.

/*
 * Dodaj znak wodny do wszystkich arkuszy skoroszytu programu Excel za pomocą języka C#
 */
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
using (Watermarker watermarker = new Watermarker(@"path/spreadsheet.xlsx", loadOptions))
{
    // Dodaj tekstowy znak wodny do arkusza roboczego
    TextWatermark textWatermark = new TextWatermark("DRAFT", new Font("Arial", 100))
    {
        RotateAngle = -45,
        Height = 200,
        Width = 500,
        Opacity = .2,
        ForegroundColor = Color.DarkBlue
    };
    // Dodaj znak wodny i zapisz arkusz kalkulacyjny ze znakiem wodnym.
    watermarker.Add(textWatermark);
    watermarker.Save(@"path/allpages-watermark-spreadsheet.xlsx");
}

Arkusz programu Excel specyficzny dla znaku wodnego przy użyciu języka C#

Podobnie możesz zastosować znaki wodne tylko do dowolnego określonego arkusza, zamiast stosować je do wszystkich arkuszy skoroszytu. Poniższe kroki opisują, jak wstawić tekstowy znak wodny do określonego arkusza skoroszytu programu Excel przy użyciu języka C#.

  • Przygotuj opcje ładowania.
  • Załaduj arkusz kalkulacyjny, używając klasy Znacznik wodny.
  • Zdefiniuj wygląd i tekst znaku wodnego za pomocą klasy TextWatermark.
  • Ustaw indeks arkusza tak, aby znak wodny był stosowany tylko do wspomnianego arkusza.
  • Dodaj tekstowy znak wodny do arkusza programu Excel za pomocą metody Dodaj z opcjami znaku wodnego.
  • Zapisz wynikowy arkusz kalkulacyjny ze znakiem wodnym za pomocą metody Save.

Poniższy fragment kodu stosuje tekstowy znak wodny tylko do wspomnianego arkusza skoroszytu programu Excel.

/*
 * Dodaj znak wodny tylko do wspomnianego arkusza skoroszytu programu Excel przy użyciu języka C#
 */
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
using (Watermarker watermarker = new Watermarker(@"path/spreadsheet.xlsx", loadOptions))
{
    // Dodaj tekstowy znak wodny do arkusza
    TextWatermark textWatermark = new TextWatermark("DRAFT", new Font("Arial", 100))
    {
        RotateAngle = -45,
        Height = 200,
        Width = 500,
        Opacity = .2,
        ForegroundColor = Color.DarkBlue
    };
    // Zdefiniuj indeks arkusza
    SpreadsheetWatermarkShapeOptions textWatermarkOptions = new SpreadsheetWatermarkShapeOptions()
    {
        WorksheetIndex = 1
    };
    // Dodaj znak wodny i zapisz arkusz kalkulacyjny ze znakiem wodnym.    
    watermarker.Add(textWatermark, textWatermarkOptions);
    watermarker.Save(@"path/onepage-watermark-spreadsheet.xlsx");
}

Arkusze programu Excel ze znakiem wodnym jako tło przy użyciu języka C#

Podobnie możemy również dodać znaki wodne jako tło arkusza kalkulacyjnego. Nastąpi niewielka zmiana w stosunku do powyższych technik stosowania znaków wodnych. Poniżej przedstawiono kroki, które umożliwiają wstawianie znaku wodnego w tle do arkusza kalkulacyjnego programu Excel przy użyciu języka C#.

  • Przygotuj opcje ładowania do ładowania arkusza kalkulacyjnego.
  • Załaduj arkusz kalkulacyjny za pomocą Znacznika wodnego.
  • Zdefiniuj tekst i wygląd znaku wodnego (obrót, położenie, wymiary, krycie, kolor i inne) za pomocą TextWatermark.
  • Ustaw opcje znaku wodnego w tle, pobierając zawartość i ustawiając wymiary.
  • Ustaw indeks arkusza roboczego, aby zastosować znak wodny. (Opcjonalny)
  • Dodaj znak wodny do arkusza kalkulacyjnego za pomocą metody Dodaj.
  • Zapisz arkusz ze znakiem wodnym metodą Save.

Poniższy przykładowy kod pokazuje, jak dodać znak wodny w tle do arkusza kalkulacyjnego programu Excel przy użyciu języka C# w aplikacji .NET.

/*
 * Dodaj znak wodny jako tło do skoroszytu programu Excel przy użyciu języka C#
 */
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
using (Watermarker watermarker = new Watermarker(@"path/spreadsheet.xlsx", loadOptions))
{
    // Zdefiniuj wygląd znaku wodnego
    TextWatermark textWatermark = new TextWatermark("DRAFT", new Font("Arial", 100))
    {
        RotateAngle = -45,
        X = 200,
        Y = 200,
        Height = 200,
        Width = 500,
        Opacity = .2,
        ForegroundColor = Color.DarkBlue
    };
    // Uzyskaj wymiary zawartości arkusza kalkulacyjnego
    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;

    // Dodaj znak wodny i zapisz arkusz kalkulacyjny ze znakiem wodnym.
    watermarker.Add(textWatermark, options);
    watermarker.Save(@"path/background-watermark-spreadsheet.xlsx");
}
Arkusze programu Excel ze znakami wodnymi programowo

Uzyskaj bezpłatną licencję API

Możesz uzyskać bezpłatną tymczasową licencję, aby korzystać z API bez ograniczeń ewaluacyjnych.

Wniosek

Podsumowując, omówiliśmy różne sposoby dodawania znaku wodnego do arkuszy programu Excel przy użyciu języka C#. Najpierw dodaliśmy tekstowe znaki wodne do wszystkich arkuszy skoroszytu programu Excel. Następnie nanieśliśmy znak wodny tylko na konkretny arkusz. Na koniec wstawiliśmy tekstowy znak wodny do skoroszytu programu Excel jako tło.

Odwiedź dokumentację produktu, aby dowiedzieć się więcej o interfejsie API. W przypadku pytań skontaktuj się z nami za pośrednictwem forum.

Zobacz też