As marcas d’água desempenham um papel crucial na gestão profissional de documentos — desde a identidade da marca até a proteção de conteúdos. Em Excel workbooks, elas podem marcar uma planilha como Confidencial”, Rascunho” ou incluir um logotipo da empresa para um branding consistente. Este artigo fornece os detalhes necessários sobre nosso SDK baseado em nuvem, que oferece flexibilidade, automação e precisão para inserir marcas d’água em workbooks do Excel.

API de Processamento do Excel

Aspose.Cells Cloud SDK for .NET oferece aos desenvolvedores C# uma maneira avançada, escalável e segura de gerenciar arquivos do Excel online. Quando se trata de marcas d’água, ele fornece:

  • Automação baseada em nuvem – Adicione ou remova marcas d’água sem instalações locais.
  • Suporte multiplataforma – Funciona em .NET Core, .NET Framework e ambientes serverless.
  • Alto desempenho – Processa eficientemente grandes pastas de trabalho na nuvem.
  • Integração RESTful – Simplifica a integração usando SDKs ou solicitações HTTP diretas.

Se você precisa aplicar uma marca d’água às planilhas do Excel para proteção ou marca, o Aspose.Cells Cloud torna o processo fácil.

Configuração do Ambiente

Antes de começar o processamento do Excel Workbook, certifique-se de que você tenha:

  1. Uma conta válida Aspose.Cloud(para obter o Client ID e o Secret).
  2. Instalou o Visual Studio ou qualquer IDE compatível com .NET.
  3. Um workbook do Excel (XLS ou XLSX) e um arquivo de imagem (logotipo ou marca d’água).

Instale o SDK usando o Gerenciador de Pacotes NuGet:

Install-Package Aspose.Cells-Cloud

Marcação d’água no Excel usando C#

O seguinte exemplo demonstra como fazer o upload de uma pasta de trabalho do Excel para o armazenamento em nuvem e aplicar uma imagem de marca d’água usando o Aspose.Cells Cloud SDK para .NET.

  1. Crie uma instância de CellsApi onde passamos as credenciais do cliente como argumentos.
CellsApi cellsInstance = new CellsApi(clientID, clientSecret);
  1. Carregue a pasta do Excel para o armazenamento em nuvem.
cellsInstance.UploadFile(input_Excel, File.OpenRead(input_Excel));
  1. Converter fluxo de imagem para array de bytes.
byte[] imageBytes = File.ReadAllBytes(watermarkImage);
  1. Chame a API para aplicar a imagem da marca d’água como um fundo em todas as planilhas da pasta de trabalho.
var response = cellsInstance.CellsWorkbookPutWorkbookBackground(input_Excel, imageBytes, null);

// Para mais exemplos, visite https://github.com/aspose-cells-cloud/aspose-cells-cloud-dotnet/

// Obtenha as credenciais do cliente em https://dashboard.aspose.cloud/
string clientId = "CLIENT_ID";
string clientSecret = "CLIENT_SECRET";
string inputExcel = "input.xlsx";
string watermarkImage = "Watermark.png";

// crie uma instância da classe CellsApi.
var cellsApi = new CellsApi(clientId, clientSecret);

// Carregue o arquivo Excel de entrada para o Cloud Storage
using (var fileStream = File.OpenRead(inputExcel))
{
    cellsApi.UploadFile(inputExcel, fileStream);
}

// Leia o arquivo de imagem da marca d'água
byte[] imageBytes = File.ReadAllBytes(watermarkImage);

// Adicionar uma marca d'água ao arquivo do Excel
var response = cellsApi.CellsWorkbookPutWorkbookBackground(inputExcel, imageBytes, null);

Console.WriteLine("Watermark successfully added to Excel workbook.");

Inserir Marca d’água no Excel usando cURL

Se você prefere automação baseada em linha de comando ou script, o Aspose.Cells Cloud também suporta operações RESTful cURL.

Passo 1. - Crie um ACCESSTOKEN baseado nas credenciais do cliente:

curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=XXXXXX-XXXXXX-XXXXXX&client_secret=XXXXXXXXXXXXX" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

Passo 2 - Faça o upload de um arquivo Excel para o armazenamento em nuvem.

curl -v "https://api.aspose.cloud/v3.0/cells/storage/file/{filePath}" \
-X PUT \
-F file=@{localFilePath} \
-H "Content-Type: multipart/form-data" \
-H "Authorization: Bearer {ACCESS_TOKEN}"

Passo 3 - Adicionar Imagem de Marca d’ Água ao arquivo do Excel.

curl -v "https://api.aspose.cloud/v3.0/cells/{excelFile}/background" \
-X PUT \
-H  "accept: multipart/form-data" \
-H  "authorization: Bearer {ACCESS_TOKEN}" \
-H  "Content-Type: multipart/form-data" \
-d  "File":{"watermarkImage"}

Replace:

  • {excelFile} - nome do arquivo Excel de entrada no armazenamento em nuvem.
  • {ACCESSTOKEN} - token JWT gerado acima.
  • {watermarkImage} - Arquivo de imagem a ser usado como marca d’água.

Watermark Excel Online

Quer testar o recurso sem codificação?

Experimente nosso Free Online Excel Watermark App — powered by Aspose.Cells Cloud. Basta fazer o upload do seu workbook Excel, aplicar seu logotipo ou imagem de marca d’água e baixar o arquivo resultante instantaneamente.

watermark excel online

Conclusão

Seja você desenvolvendo um sistema de automação de documentos ou integrando a marcação de arquivos do Excel em seu fluxo de trabalho de aplicação, este SDK permite a marca d’água do Excel na nuvem de forma contínua - segura, escalável e amigável ao desenvolvedor.

Perguntas Frequentes (FAQs)

  1. A API de marca d’água do Excel suporta marcas d’água em imagem e texto? A API permite que você adicione marcas d’água baseadas em imagem (como PNG, JPEG ou BMP).Em relação às marcas d’água baseadas em texto, você pode implementá-las sobrepondo texto por meio das APIs de desenho ou forma.

  2. Posso aplicar uma marca d’água diferente para cada planilha no arquivo do Excel? Sim. O Aspose.Cells Cloud SDK oferece controle granular sobre planilhas individuais. Você pode usar o CellsWorksheetPutBackground() método para aplicar uma marca d'água exclusiva a uma planilha específica em vez de todo o livro de trabalho.

  3. Do I need Microsoft Excel installed to use the Aspose.Cells Cloud SDK? Não. O Aspose.Cells Cloud SDK para .NET é completamente baseado em nuvem, o que significa que você pode aplicar ou remover marcas d'água de arquivos Excel sem instalar o Microsoft Excel ou qualquer software adicional de desktop.

  4. Os meus dados estão seguros durante o processamento de marcas d’água do Excel na nuvem? Sim. Aspose.Cells Cloud utiliza criptografia SSL para transmissão de dados e armazena arquivos de forma segura na nuvem. Os arquivos enviados são excluídos automaticamente após a conclusão da operação (com base no período de retenção que você seleciona para o seu armazenamento mapeado).

Artigos Recomendados

Recomendamos que você visite os links g para saber mais sobre: