Adicionar marca d'água a documentos do Word usando a API REST em C#

Você pode adicionar um texto ou uma imagem como marca d’água aos seus documentos do Word programaticamente na nuvem. As marcas d’água são usadas para identificar o criador do documento ou outras informações, como direitos autorais ou logotipo, etc. Normalmente, a marca d’água é usada na forma de uma imagem sobreposta, logotipo, padrão ou texto inserido no documento. Neste artigo, você aprenderá como adicionar uma marca d’água a documentos do Word usando uma API REST em C#.

Os seguintes tópicos serão abordados neste artigo:

API REST de marca d’água e SDK .NET

Para adicionar marca d’água de texto ou imagem a arquivos DOCX, usarei a API .NET SDK do GroupDocs.Watermark Cloud. Ele permite que você adicione, remova, pesquise e substitua programaticamente marcas d’água de imagens e documentos dos formatos de arquivo suportados, como PDF, Microsoft Word e Powerpoint. Além disso, você pode controlar a personalização de marcas d’água especificando o estilo de texto, fonte, tamanho, cor ou posição de acordo com seus requisitos. Atualmente, também fornece Java SDK para API Cloud.

Você pode instalar GroupDocs.Watermark Cloud em seu projeto do Visual Studio a partir do Gerenciador de Pacotes NuGet ou usando o seguinte comando no console do Gerenciador de Pacotes:

Install-Package GroupDocs.Watermark-Cloud

Obtenha seu ID e Segredo do cliente no painel antes de seguir as etapas mencionadas. Depois de ter seu ID e segredo, adicione o código conforme mostrado abaixo:

string clientId = "da0c487d-c1c0-45ae-b7bf-43eaf53c5ad5";
string clientSecret = "479db2b01dcb93a3d4d20efb16dea971";
string myStorage = "";

var configuration = new Configuration(clientId, clientSecret);
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";

Adicionar marca d’água de texto a documentos do Word usando a API REST em C#

Você pode adicionar qualquer texto como marca d’água aos seus documentos do Word programaticamente seguindo as etapas simples mencionadas abaixo:

Carregue o Documento

Em primeiro lugar, carregue o documento do Word para a nuvem usando o exemplo de código abaixo:

// inicializar API
var fileApi = new FileApi(configuration);

// abrir arquivo
var fileStream = File.Open(@"C:\Files\sample.docx", FileMode.Open);

// criar solicitação de upload de arquivo
var request = new UploadFileRequest("sample.docx", fileStream, MyStorage);

// subir arquivo
fileApi.UploadFile(request);
fileStream.Close();

Como resultado, o arquivo DOCX será carregado no armazenamento em nuvem e estará disponível na seção de arquivos do seu painel.

Adicionar marca d’água de texto ao DOCX usando C#

Você pode adicionar uma marca d’água de texto ao arquivo DOCX programaticamente seguindo as etapas abaixo.

  • Crie uma instância da WatermarkApi
  • Crie uma instância do FileInfo
  • Defina o caminho do arquivo DOCX
  • Crie WatermarkOptions e defina FileInfo
  • Criar TextWatermarkOptions
  • Defina o texto, a família da fonte, o tamanho da fonte e o alinhamento do texto
  • Definir cor de primeiro plano do texto da marca d’água
  • Definir a posição da marca d’água
  • Defina WatermarkDetails e defina TextWatermarkOptions e Position
  • Criar AddRequest com WatermarkOptions
  • Obtenha resultados chamando o método WatermarkApi.add()

O exemplo de código a seguir mostra como adicionar texto como marca d’água a um documento do Word usando uma API REST em C#.

// inicializar API
var apiInstance = new WatermarkApi(configuration);

// caminho do arquivo de entrada
var fileInfo = new FileInfo
{
    FilePath = "sample.docx"
};

// criar opções de marca d'água
var options = new WatermarkOptions()
{
    FileInfo = fileInfo,
    
    // definir detalhes da marca d'água
    WatermarkDetails = new List<WatermarkDetails>
    {
        new WatermarkDetails
        {
            // definir marca d'água de texto
            TextWatermarkOptions = new TextWatermarkOptions
            {
                Text = "Copyright© 2021",
                FontFamilyName = "Arial",
                FontSize = 22d,
                TextAlignment = "Center",
                ForegroundColor = new Color()
                {
                    Name = "Red"
                }
            },

            // definir a posição da marca d'água
            Position = new Position()
            {
                X = 230.0,
                Y = 500.0
            }
        }
    }
};

// criar adicionar pedido
var request = new AddRequest(options);

// Adicione uma Marca D'água
var response = apiInstance.Add(request);

Console.WriteLine("Resultant file path: " + response.DownloadUrl);
Adicionar marca d'água de texto a documentos do Word usando a API REST em C#

Adicionar marca d’água de texto a documentos do Word usando a API REST em C#

Baixe o arquivo atualizado

O exemplo de código acima salvará o arquivo do Word com uma marca d’água de texto na nuvem. Você pode baixá-lo usando o seguinte exemplo de código:

// inicializar API
var fileApi = new FileApi(configuration);

// caminho de arquivo padrão na nuvem
var file = "watermark/added_watermark/sample_docx/sample.docx";

// criar solicitação de download de arquivo
var downloadRequest = new DownloadFileRequest(file, myStorage);

// ⇬ Fazer download do arquivo
Stream downloadResponse = fileApi.DownloadFile(downloadRequest);

// salvar arquivo no diretório de trabalho
using (var fileStream = System.IO.File.Create("C:\\Files\\DownloadedFile.docx"))
{
    downloadResponse.Seek(0, SeekOrigin.Begin);
    downloadResponse.CopyTo(fileStream);
}

Adicionar marca d’água de imagem a documentos do Word usando a API REST

Você pode adicionar uma imagem ou um logotipo como marca d’água aos seus documentos do Word programaticamente seguindo as etapas abaixo.

  • Crie uma instância da WatermarkApi
  • Crie uma instância do FileInfo
  • Defina o caminho do arquivo DOCX
  • Crie WatermarkOptions e defina FileInfo
  • Criar ImageWatermarkOptions
  • Definir FilePath de uma imagem PNG para marca d’água com
  • Definir a posição da marca d’água
  • Criar detalhes da marca d’água
  • Definir opções e posição da marca d’água da imagem
  • Definir detalhes da marca d’água para listar
  • Criar AddRequest com WatermarkOptions
  • Obtenha resultados chamando o método WatermarkApi.add()

O exemplo de código a seguir mostra como adicionar uma imagem como marca d’água ao DOCX usando uma API REST em C#. Siga as etapas mencionadas anteriormente para fazer upload e download dos arquivos.

// inicializar API
var apiInstance = new WatermarkApi(configuration);

// caminho do arquivo de entrada
var fileInfo = new FileInfo
{
    FilePath = "sample.docx"
};

// criar opções de marca d'água
var options = new WatermarkOptions()
{
    FileInfo = fileInfo,
    // definir detalhes da marca d'água
    WatermarkDetails = new List<WatermarkDetails>
    {
        new WatermarkDetails
        {
            // definir marca d'água de imagem
            ImageWatermarkOptions = new ImageWatermarkOptions()
            {
                Image = new FileInfo { 
                    FilePath = "logo.png" 
                }
            },

            // definir a posição da marca d'água
            Position = new Position()
            {
                X = 180.0,
                Y = 280.0
            }
        }
    }
};

// criar adicionar solicitação
var request = new AddRequest(options);

// Adicione uma Marca D'água
var response = apiInstance.Add(request);

Console.WriteLine("Resultant file path: " + response.DownloadUrl);
Adicionar marca d'água de imagem a imagens usando a API REST em C#

Adicionar marca d’água de imagem a documentos do Word usando a API REST em C#

Experimente on-line

Experimente a seguinte ferramenta de marca d’água on-line gratuita, desenvolvida usando a API acima. https://products.groupdocs.app/watermark/docx

Conclusão

Concluindo, você aprendeu como adicionar marca d’água de texto ou imagem a um documento do Word na nuvem. Você também aprendeu como carregar programaticamente os arquivos DOCX na nuvem e, em seguida, baixar o arquivo atualizado da nuvem. Você pode aprender mais sobre GroupDocs.Watermark Cloud API na documentação. Também fornecemos uma seção Referência de API que permite visualizar e interagir com nossas APIs diretamente pelo navegador. Em caso de ambiguidade, sinta-se à vontade para entrar em contato com suporte.

Veja também