excel comparison on Document Processing REST APIs | GroupDocs Cloud

Comparar arquivos Excel via REST em C#

Fri, 09 Oct 2026 14:45:06 +0000

Comparar planilhas do Excel programaticamente é uma necessidade frequente quando você precisa detectar alterações de dados, auditar revisões ou gerar relatórios. GroupDocs.Comparison Cloud SDK for .NET fornece uma poderosa biblioteca baseada em REST que facilita a comparação de arquivos Excel via REST em C#. Este guia orienta você sobre como fazer upload de arquivos, configurar opções de comparação, executar a comparação e recuperar o resultado, com exemplos de código em C# e cURL.

Compare arquivos Excel via REST em C# em 5 etapas

Carregue o arquivo [XLSX] de origem: Use o método StorageApi.UploadFile para colocar sample1.xlsx no armazenamento em nuvem.

using (var stream1 = new FileStream(localFilePath1, FileMode.Open, FileAccess.Read))
{
    var uploadRequest1 = new UploadFileRequest(remoteFilePath1, stream1);
    storageApi.UploadFile(uploadRequest1);
}

Carregue o arquivo XLSX de destino: Repita o upload para sample2.xlsx.

using (var stream2 = new FileStream(localFilePath2, FileMode.Open, FileAccess.Read))
{
    var uploadRequest2 = new UploadFileRequest(remoteFilePath2, stream2);
    storageApi.UploadFile(uploadRequest2);
}

Configure as opções de comparação: Crie um objeto CompareOptions, defina os caminhos dos arquivos de origem e destino, especifique o caminho de saída e ajuste configurações como GenerateSummaryPage.

var compareOptions = new CompareOptions
{
    SourceFile = new FileInfo { FilePath = remoteFilePath1 },
    TargetFiles = new List
    {
        new FileInfo { FilePath = remoteFilePath2 }
    },
    OutputPath = remoteResultPath,
    Settings = new Settings
    {
        GenerateSummaryPage = true,
        ShowDeletedContent = true,
        ShowInsertedContent = true
    }
};

Consulte a referência completa da API para CompareOptions e Settings em Referência da API.
4. Execute a comparação: Chame CompareApi.CompareDocument com um CompareDocumentRequest.

var compareRequest = new CompareDocumentRequest(compareOptions);
var compareResult = compareApi.CompareDocument(compareRequest);

Baixe o resultado e faça a limpeza: Recupere o result.xlsx gerado, salve-o localmente e, opcionalmente, exclua os arquivos remotos.

var downloadRequest = new DownloadFileRequest(compareResult.Path);
using (var resultStream = storageApi.DownloadFile(downloadRequest))
using (var fileStream = new FileStream(localResultPath, FileMode.Create, FileAccess.Write))
{
    resultStream.CopyTo(fileStream);
}

// Clean up
storageApi.DeleteFile(new DeleteFileRequest(remoteFilePath1));
storageApi.DeleteFile(new DeleteFileRequest(remoteFilePath2));
storageApi.DeleteFile(new DeleteFileRequest(remoteResultPath));

Exemplo completo de código: comparar arquivos Excel via REST em C# usando GroupDocs.Comparison

Este exemplo demonstra como fazer upload de dois arquivos XLSX, compará‑los e baixar o resultado destacado.

using System;
using System.Collections.Generic;
using System.IO;
using GroupDocs.Comparison.Cloud.Sdk.Api;
using GroupDocs.Comparison.Cloud.Sdk.Client;
using GroupDocs.Comparison.Cloud.Sdk.Model;
using GroupDocs.Comparison.Cloud.Sdk.Model.Requests;

namespace CompareExcelFilesExample
{
    class Program
    {
        static void Main(string[] args)
        {
            // Configuration – replace with your actual credentials
            var config = new Configuration
            {
                ClientId = "YOUR_CLIENT_ID",
                ClientSecret = "YOUR_CLIENT_SECRET"
            };

// APIs
            var compareApi = new CompareApi(config);
            var storageApi = new StorageApi(config);

// Local and remote file names
            string localFilePath1 = "sample1.xlsx";
            string localFilePath2 = "sample2.xlsx";
            string remoteFilePath1 = "sample1.xlsx";
            string remoteFilePath2 = "sample2.xlsx";
            string remoteResultPath = "result.xlsx";
            string localResultPath = "result.xlsx";

// Upload first Excel file
            using (var stream1 = new FileStream(localFilePath1, FileMode.Open, FileAccess.Read))
            {
                var uploadRequest1 = new UploadFileRequest(remoteFilePath1, stream1);
                storageApi.UploadFile(uploadRequest1);
            }

// Upload second Excel file
            using (var stream2 = new FileStream(localFilePath2, FileMode.Open, FileAccess.Read))
            {
                var uploadRequest2 = new UploadFileRequest(remoteFilePath2, stream2);
                storageApi.UploadFile(uploadRequest2);
            }

// Prepare comparison options
            var compareOptions = new CompareOptions
            {
                SourceFile = new FileInfo { FilePath = remoteFilePath1 },
                TargetFiles = new List
                {
                    new FileInfo { FilePath = remoteFilePath2 }
                },
                OutputPath = remoteResultPath,
                Settings = new Settings
                {
                    // Example: show changes in a new sheet
                    GenerateSummaryPage = true,
                    ShowDeletedContent = true,
                    ShowInsertedContent = true
                }
            };

// Execute comparison
            var compareRequest = new CompareDocumentRequest(compareOptions);
            var compareResult = compareApi.CompareDocument(compareRequest);

// Download the result file
            var downloadRequest = new DownloadFileRequest(compareResult.Path);
            using (var resultStream = storageApi.DownloadFile(downloadRequest))
            using (var fileStream = new FileStream(localResultPath, FileMode.Create, FileAccess.Write))
            {
                resultStream.CopyTo(fileStream);
            }

// Optional: clean up remote files
            storageApi.DeleteFile(new DeleteFileRequest(remoteFilePath1));
            storageApi.DeleteFile(new DeleteFileRequest(remoteFilePath2));
            storageApi.DeleteFile(new DeleteFileRequest(remoteResultPath));

Console.WriteLine("Comparison completed. Result saved to " + localResultPath);
        }
    }
}

Nota: Este exemplo de código demonstra a funcionalidade principal. Antes de usá‑lo em seu projeto, certifique‑se de atualizar quaisquer caminhos de arquivos e valores de configuração para corresponder ao seu ambiente real, verifique se todas as dependências necessárias estão instaladas corretamente e teste minuciosamente em seu ambiente de desenvolvimento. Se encontrar algum problema, consulte a documentação oficial ou entre em contato com a equipe de suporte para obter assistência.

Chamando a API REST de Comparação com cURL

Abaixo está um fluxo de trabalho cURL que realiza a mesma operação sem escrever código C#. Substitua os valores de espaço reservado pelas suas credenciais reais e pelos nomes dos arquivos.

Obtenha um token de acesso

curl -X POST "https://api.groupdocs.cloud/v2.0/oauth2/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

Carregue o arquivo XLSX de origem

curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/sample1.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" \
     --data-binary "@sample1.xlsx"

Carregue o arquivo XLSX de destino

curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/sample2.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" \
     --data-binary "@sample2.xlsx"

Execute a comparação

curl -X POST "https://api.groupdocs.cloud/v2.0/comparison/compare" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "source_file": {"file_path": "sample1.xlsx"},
           "target_files": [{"file_path": "sample2.xlsx"}],
           "output_path": "result.xlsx",
           "settings": {
               "generate_summary_page": true,
               "show_deleted_content": true,
               "show_inserted_content": true
           }
         }'

Baixe o resultado

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/result.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o result.xlsx

Para obter uma lista completa de endpoints e parâmetros, veja a documentação oficial da API.

Pré-requisitos e Configuração

Instale o pacote .NET via NuGet:

dotnet add package GroupDocs.Comparison-Cloud

Certifique-se de que possui uma conta válida do GroupDocs Cloud e obtenha seu Client Id e Client Secret no painel.
.NET 6.0 ou posterior é necessário.

Você pode baixar a biblioteca mais recente na página de download.

Ajustando Configurações de Comparação

O objeto Settings dentro de CompareOptions permite controlar a saída. Ajustes comuns incluem:

GenerateSummaryPage - adiciona uma planilha de resumo com estatísticas de alterações.
ShowDeletedContent - destaca as células que foram removidas.
ShowInsertedContent - destaca as células recém adicionadas.

Essas propriedades já são usadas no exemplo de código acima. Para opções adicionais, como proteção Password ou StyleChangeDetection, consulte a Referência da API.

Conclusão

Comparar arquivos Excel via REST em C# torna-se simples com o GroupDocs.Comparison Cloud SDK for .NET. Seguindo as etapas, você pode fazer upload de arquivos XLSX, configurar configurações detalhadas de comparação, executar a comparação e recuperar uma pasta de trabalho de resultado que marca claramente as diferenças. Lembre-se de proteger suas credenciais de API, respeitar os limites de tamanho de arquivo e usar uma licença temporária para desenvolvimento. Quando estiver pronto para produção, adquira uma licença completa na página de preços para desbloquear uso ilimitado.

FAQs

Como comparo arquivos Excel via REST em C# usando GroupDocs.Comparison?
Use o SDK para enviar dois arquivos XLSX, defina CompareOptions, chame CompareDocument e baixe o arquivo resultante. O fluxo completo é ilustrado nas seções de código e cURL acima.
Qual método de autenticação a API REST requer?
A API usa OAuth 2.0 com seu client‑id e client‑secret para obter um token de acesso, que deve ser enviado no cabeçalho Authorization: Bearer para cada requisição.
Posso personalizar quais alterações são destacadas no resultado da comparação?
Sim. Ajuste o objeto Settings (por exemplo, GenerateSummaryPage, ShowDeletedContent, ShowInsertedContent) para controlar a aparência das diferenças.
É uma licença temporária suficiente para testes?
Uma licença temporária da página de licença temporária funciona para desenvolvimento e teste. Para implantações de produção, adquira uma licença completa.

Comparar arquivos Excel via REST em C#

Mon, 21 Sep 2026 11:32:39 +0000

Analisar mudanças entre versões de planilhas é uma tarefa rotineira para finanças, relatórios e fluxos de trabalho de validação de dados. GroupDocs.Comparison Cloud SDK for .NET fornece uma API poderosa que facilita a comparação de arquivos Excel em .NET sem inspeção manual. Neste guia, você verá como configurar a biblioteca, fazer upload de pastas de trabalho, chamar o endpoint REST a partir do C#, recuperar informações detalhadas sobre as alterações e ajustar finamente as opções de comparação para obter resultados precisos.

Antes de Começar: Pré-requisitos e Instalação

Antes de começar, certifique‑se de que você tem o seguinte:

.NET 6.0 ou posterior instalado.
Uma IDE como o Visual Studio 2022.
Uma conta do GroupDocs Cloud com ClientId e ClientSecret.
Acesso ao armazenamento do GroupDocs Cloud onde os arquivos Excel serão enviados.

Instale o SDK via NuGet:

dotnet add package GroupDocs.Comparison-Cloud

Baixe o pacote mais recente na página de lançamentos. Após a instalação, adicione suas credenciais no código conforme mostrado a seguir. Agora você está pronto para iniciar o fluxo de trabalho de comparação.

Guia passo a passo para comparar arquivos Excel no .NET

As etapas a seguir ilustram como comparar arquivos Excel em .NET usando o SDK.

Etapa 1: Carregar os documentos de origem e destino

Crie um objeto de configuração com suas credenciais e instancie o CompareApi.

var config = new Configuration
{
    ClientId = "YOUR_CLIENT_ID",
    ClientSecret = "YOUR_CLIENT_SECRET"
};

var compareApi = new CompareApi(config);

Passo 2: Prepare as pastas de trabalho do Excel

Defina objetos FileInfo que apontam para os arquivos XLSX de origem e destino armazenados no armazenamento do GroupDocs Cloud.

var sourceFile = new FileInfo { FilePath = "input/source.xlsx" };
var targetFile = new FileInfo { FilePath = "input/target.xlsx" };

Etapa 3: Definir Opções e Configurações de Comparação

Configure o objeto CompareOptions, incluindo configurações detalhadas de alterações.

var compareOptions = new CompareOptions
{
    SourceFile = sourceFile,
    TargetFiles = new List { targetFile },
    OutputPath = "output/diff_result.xlsx",
    Settings = new Settings
    {
        ShowDeletedContent = true,
        ShowInsertedContent = true,
        ShowStyleChanges = true,
        GenerateSummaryPage = true
    }
};

Para obter uma lista completa de configurações, consulte a referência da API.

Etapa 4: Executar a Comparação e Processar os Resultados

Chame o método Compare e leia as informações básicas do resultado.

var compareResult = compareApi.Compare(compareOptions);
Console.WriteLine($"Comparison completed. Result file: {compareResult.Path}");
Console.WriteLine($"Number of changes detected: {compareResult.Changes?.Count ?? 0}");

Etapa 5: Recuperar informações detalhadas de alterações

Se precisar de um relatório detalhado, use a solicitação GetChanges.

var changesRequest = new GetChangesRequest
{
    SourceFile = sourceFile,
    TargetFile = targetFile,
    OutputPath = "output/detailed_changes.json"
};
var detailedChanges = compareApi.GetChanges(changesRequest);
Console.WriteLine($"Detailed changes saved to: {detailedChanges.Path}");

Com estas etapas, você automatizou totalmente o processo de comparação de arquivos Excel no .NET.

Comparando Arquivos Excel Programaticamente - Exemplo de Código Completo

O código a seguir demonstra o fluxo de trabalho completo, da configuração ao tratamento do resultado.

using System;
using System.Collections.Generic;
using GroupDocs.Comparison.Cloud.Sdk.Api;
using GroupDocs.Comparison.Cloud.Sdk.Client;
using GroupDocs.Comparison.Cloud.Sdk.Model;

namespace CompareExcelDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            // Set up API credentials (replace with your actual credentials)
            var config = new Configuration
            {
                ClientId = "YOUR_CLIENT_ID",
                ClientSecret = "YOUR_CLIENT_SECRET"
            };

// Initialize Compare API
            var compareApi = new CompareApi(config);

// Prepare source and target Excel files (must be uploaded to GroupDocs Cloud storage beforehand)
            var sourceFile = new FileInfo { FilePath = "input/source.xlsx" };
            var targetFile = new FileInfo { FilePath = "input/target.xlsx" };

// Define comparison options
            var compareOptions = new CompareOptions
            {
                SourceFile = sourceFile,
                TargetFiles = new List { targetFile },
                OutputPath = "output/diff_result.xlsx",
                // Optional: specify that we want detailed changes for worksheets
                Settings = new Settings
                {
                    ShowDeletedContent = true,
                    ShowInsertedContent = true,
                    ShowStyleChanges = true,
                    GenerateSummaryPage = true
                }
            };

try
            {
                // Call the Compare API
                var compareResult = compareApi.Compare(compareOptions);

// Output basic result information
                Console.WriteLine($"Comparison completed. Result file: {compareResult.Path}");
                Console.WriteLine($"Number of changes detected: {compareResult.Changes?.Count ?? 0}");

// Iterate through change details
                if (compareResult.Changes != null)
                {
                    foreach (var change in compareResult.Changes)
                    {
                        Console.WriteLine("--------------------------------------------------");
                        Console.WriteLine($"Change Type   : {change.ChangeType}");
                        Console.WriteLine($"Worksheet     : {change.Worksheet}");
                        Console.WriteLine($"Cell Address  : {change.CellAddress}");
                        Console.WriteLine($"Old Value     : {change.OldValue}");
                        Console.WriteLine($"New Value     : {change.NewValue}");
                        Console.WriteLine($"Is New Row    : {change.IsNewRow}");
                        Console.WriteLine($"Is New Column : {change.IsNewColumn}");
                    }
                }

// Retrieve detailed changes via GetChanges (optional)
                var changesRequest = new GetChangesRequest
                {
                    SourceFile = sourceFile,
                    TargetFile = targetFile,
                    OutputPath = "output/detailed_changes.json"
                };
                var detailedChanges = compareApi.GetChanges(changesRequest);
                Console.WriteLine($"Detailed changes saved to: {detailedChanges.Path}");
            }
            catch (ApiException apiEx)
            {
                Console.WriteLine($"API error: {apiEx.ErrorCode} - {apiEx.Message}");
            }
            catch (Exception ex)
            {
                Console.WriteLine($"Unexpected error: {ex.Message}");
            }
        }
    }
}

Nota: Este exemplo de código demonstra a funcionalidade principal. Antes de usá‑lo em seu projeto, certifique‑se de atualizar quaisquer caminhos de arquivo e valores de configuração para corresponder ao seu ambiente real, verifique se todas as dependências necessárias estão devidamente instaladas e teste minuciosamente em seu ambiente de desenvolvimento. Se encontrar algum problema, consulte a documentação oficial ou entre em contato com a equipe de suporte para obter assistência.

Executar Comparação de Excel via REST com cURL

Você pode obter o mesmo resultado sem escrever código C# chamando a API REST diretamente.

1. Autenticar e Obter Token de Acesso

curl -X POST "https://api.groupdocs.cloud/v1.0/oauth2/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

2. Carregar a Pasta de Trabalho de Origem

curl -X PUT "https://api.groupdocs.cloud/v1.0/storage/file?path=input/source.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -T "./source.xlsx"

3. Carregar a Pasta de Trabalho de Destino

curl -X PUT "https://api.groupdocs.cloud/v1.0/storage/file?path=input/target.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -T "./target.xlsx"

4. Execute a Comparação

curl -X POST "https://api.groupdocs.cloud/v1.0/comparison/compare" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "source_file": {"file_path":"input/source.xlsx"},
           "target_files": [{"file_path":"input/target.xlsx"}],
           "output_path":"output/diff_result.xlsx",
           "settings": {
               "show_deleted_content": true,
               "show_inserted_content": true,
               "show_style_changes": true,
               "generate_summary_page": true
           }
         }'

5. Baixe a Pasta de Trabalho de Diferença Resultante

curl -X GET "https://api.groupdocs.cloud/v1.0/storage/file?path=output/diff_result.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o diff_result.xlsx

Para obter uma lista completa de parâmetros, veja a documentação oficial da API.

Conclusão

Usando o GroupDocs.Comparison Cloud SDK for .NET você pode comparar facilmente arquivos Excel no .NET e obter uma planilha de diferenças detalhada que destaca cada modificação. A arquitetura baseada em REST do SDK permite integrar a comparação de planilhas em qualquer serviço C#, API web ou tarefa em segundo plano com esforço mínimo. Lembre‑se de adquirir uma licença adequada para uso em produção; uma licença temporária está disponível na página de licença e os detalhes completos de licenciamento estão listados no site do produto. Comece a automatizar seus fluxos de trabalho de diff de Excel hoje e elimine erros de inspeção manual.

Perguntas Frequentes

Como posso comparar arquivos Excel em .NET sem escrever muito código?
O SDK abstrai o trabalho pesado. Você só precisa configurar as credenciais, apontar para os dois arquivos XLSX e chamar compareApi.Compare. A biblioteca retorna um arquivo de diff e uma lista de objetos de alteração.
Qual formato o resultado do diff usa?
Por padrão, o resultado é salvo como uma pasta de trabalho XLSX, preservando o layout original enquanto aplica marcadores visuais para exclusões, inserções e alterações de estilo.
É possível comparar pastas de trabalho do Excel protegidas?
Sim. Forneça a senha na propriedade Password do objeto FileInfo. A API desbloqueará a pasta de trabalho antes de executar a comparação.
Preciso de uma licença para desenvolvimento e teste?
Uma licença temporária pode ser obtida na página de licença. Para implantações de produção, você deve adquirir uma licença completa conforme descrito na página do produto.

excel comparison on Document Processing REST APIs | GroupDocs Cloud

Comparar arquivos Excel via REST em C#

Compare arquivos Excel via REST em C# em 5 etapas

Exemplo completo de código: comparar arquivos Excel via REST em C# usando GroupDocs.Comparison

Chamando a API REST de Comparação com cURL

Pré-requisitos e Configuração

Ajustando Configurações de Comparação

Conclusão

FAQs

Read More

Comparar arquivos Excel via REST em C#

Antes de Começar: Pré-requisitos e Instalação

Guia passo a passo para comparar arquivos Excel no .NET

Etapa 1: Carregar os documentos de origem e destino

Passo 2: Prepare as pastas de trabalho do Excel

Etapa 3: Definir Opções e Configurações de Comparação

Etapa 4: Executar a Comparação e Processar os Resultados

Etapa 5: Recuperar informações detalhadas de alterações

Comparando Arquivos Excel Programaticamente - Exemplo de Código Completo

Executar Comparação de Excel via REST com cURL

Conclusão

Perguntas Frequentes

Leia Mais