Adicionar marca d'água à planilha do Excel usando C #

Já discutimos maneiras de marcar diferentes documentos, imagens e apresentações. Hoje, discutiremos como adicionar marca d’água a uma pasta de trabalho do Excel de diferentes maneiras usando C# com o aplicativo .NET.

Os seguintes tópicos são abordados abaixo:

.NET API para marcar planilhas do Excel com marca d’água

GroupDocs.Watermark fornece a API .NET para documentos e imagens de vários formatos de arquivo. Usaremos GroupDocs.Watermark for .NET para aplicar marcas d’água em planilhas de diferentes maneiras usando C#.

Você pode baixar o instalador de DLLs ou MSI na seção de downloads ou obtê-lo em NuGet.

Install-Package GroupDocs.Watermark

Folhas de Excel de marca d’água usando C

A API permite inserir texto nas planilhas como marca d’água com diferentes personalizações. A seguir estão as etapas para adicionar uma marca d’água a pastas de trabalho do Excel usando C# com os aplicativos .NET.

  • Preparar as opções de carregamento da planilha.
  • Carregue a planilha usando Watermarker.
  • Defina o texto e a aparência da marca d’água usando TextWatermark.
  • Adicione a marca d’água de texto à planilha do Excel usando o método Add.
  • Salve a planilha resultante com marca d’água usando o método Save.

O exemplo de código C# a seguir aplica a marca d’água de texto a todas as planilhas da pasta de trabalho do Excel com rotação e opacidade.

/*
 * Adicionar marca d'água a todas as planilhas da pasta de trabalho do Excel usando C#
 */
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
using (Watermarker watermarker = new Watermarker(@"path/spreadsheet.xlsx", loadOptions))
{
    // Adicionar marca d'água de texto à planilha
    TextWatermark textWatermark = new TextWatermark("DRAFT", new Font("Arial", 100))
    {
        RotateAngle = -45,
        Height = 200,
        Width = 500,
        Opacity = .2,
        ForegroundColor = Color.DarkBlue
    };
    // Adicione marca d'água e salve a planilha com marca d'água.
    watermarker.Add(textWatermark);
    watermarker.Save(@"path/allpages-watermark-spreadsheet.xlsx");
}

Folha de Excel específica de marca d’água usando C

Da mesma forma, você pode aplicar marcas d’água apenas a qualquer planilha específica, em vez de aplicá-las a todas as planilhas da pasta de trabalho. As etapas a seguir orientam sobre como inserir marca d’água de texto na planilha específica da pasta de trabalho do Excel usando C#.

  • Prepare as opções de carregamento.
  • Carregue a planilha usando a classe Watermarker.
  • Defina a aparência e o texto da marca d’água usando a classe TextWatermark.
  • Defina o índice da planilha para que a marca d’água seja aplicada apenas na planilha mencionada.
  • Adicione a marca d’água de texto à planilha do Excel usando o método Add com opções de marca d’água.
  • Salve a planilha de saída com a marca d’água usando o método Save.

O trecho de código a seguir aplica a marca d’água de texto apenas à planilha mencionada da pasta de trabalho do Excel.

/*
 * Adicione marca d'água apenas à planilha mencionada da pasta de trabalho do Excel usando C#
 */
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
using (Watermarker watermarker = new Watermarker(@"path/spreadsheet.xlsx", loadOptions))
{
    // Adicionar marca d'água de texto à planilha
    TextWatermark textWatermark = new TextWatermark("DRAFT", new Font("Arial", 100))
    {
        RotateAngle = -45,
        Height = 200,
        Width = 500,
        Opacity = .2,
        ForegroundColor = Color.DarkBlue
    };
    // Definir o índice da planilha
    SpreadsheetWatermarkShapeOptions textWatermarkOptions = new SpreadsheetWatermarkShapeOptions()
    {
        WorksheetIndex = 1
    };
    // Adicione marca d'água e salve a planilha com marca d'água.    
    watermarker.Add(textWatermark, textWatermarkOptions);
    watermarker.Save(@"path/onepage-watermark-spreadsheet.xlsx");
}

Folhas de Excel de marca d’água como plano de fundo usando C

Da mesma forma, também podemos adicionar marcas d’água como plano de fundo da planilha. Haverá uma pequena mudança nas técnicas acima de aplicação de marcas d’água. A seguir estão as etapas que permitem inserir marca d’água de texto em segundo plano na planilha do Excel usando C#.

  • Preparar as opções de carregamento para planilha de carregamento.
  • Carregue a planilha usando Watermarker.
  • Defina o texto e a aparência da marca d’água (rotação, posição, dimensões, opacidade, cor e mais) usando TextWatermark.
  • Defina as opções de marca d’água de fundo obtendo conteúdo e definindo dimensões.
  • Defina o índice da planilha para aplicar marca d’água. (Opcional)
  • Adicione a marca d’água à planilha usando o método Add.
  • Salve a planilha com marca d’água usando o método Save.

O exemplo de código a seguir mostra como adicionar uma marca d’água em segundo plano a uma planilha do Excel usando C# no aplicativo .NET.

/*
 * Adicionar marca d'água como plano de fundo à pasta de trabalho do Excel usando C#
 */
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
using (Watermarker watermarker = new Watermarker(@"path/spreadsheet.xlsx", loadOptions))
{
    // Definir a aparência da marca d'água
    TextWatermark textWatermark = new TextWatermark("DRAFT", new Font("Arial", 100))
    {
        RotateAngle = -45,
        X = 200,
        Y = 200,
        Height = 200,
        Width = 500,
        Opacity = .2,
        ForegroundColor = Color.DarkBlue
    };
    // Obter dimensões do conteúdo da planilha
    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;

    // Adicione marca d'água e salve a planilha com marca d'água.
    watermarker.Add(textWatermark, options);
    watermarker.Save(@"path/background-watermark-spreadsheet.xlsx");
}
Marca d'água planilhas do Excel programaticamente

Obtenha uma licença de API gratuita

Você pode obter uma licença temporária gratuita para usar a API sem as limitações de avaliação.

Conclusão

Para resumir, discutimos diferentes maneiras de adicionar marca d’água a planilhas do Excel usando C#. Primeiro, adicionamos marcas d’água de texto a todas as planilhas da pasta de trabalho do Excel. Em seguida, aplicamos a marca d’água apenas na planilha específica. Por fim, inserimos a marca d’água baseada em texto na pasta de trabalho do Excel como plano de fundo.

Visite a documentação do produto para saber mais sobre a API. Para dúvidas, entre em contato conosco através do fórum.

Veja também