excel comparison on Document Processing REST APIs | GroupDocs Cloud

Confronta file Excel tramite REST in C#

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

Confrontare i fogli di lavoro Excel programmaticamente è una necessità frequente quando è necessario rilevare modifiche ai dati, verificare revisioni o generare report. GroupDocs.Comparison Cloud SDK for .NET fornisce una potente libreria basata su REST che semplifica il confronto dei file Excel tramite REST in C#. Questa guida ti accompagna nel caricamento dei file, nella configurazione delle opzioni di confronto, nell’esecuzione del confronto e nel recupero del risultato, con esempi di codice C# e cURL.

Confronta file Excel tramite REST in C# in 5 passaggi

Carica il file XLSX di origine: Utilizza il metodo StorageApi.UploadFile per posizionare sample1.xlsx nell’archivio cloud.

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

Carica il file XLSX di destinazione: Ripeti il caricamento per sample2.xlsx.

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

Configura le opzioni di confronto: Crea un oggetto CompareOptions, imposta i percorsi dei file di origine e destinazione, definisci il percorso di output e regola le impostazioni come 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
    }
};

Consulta il riferimento API completo per CompareOptions e Settings al Riferimento API.
4. Esegui il confronto: Chiama CompareApi.CompareDocument con una CompareDocumentRequest.

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

Scarica il risultato e pulisci: Recupera il file result.xlsx generato, salvalo localmente e, facoltativamente, elimina i file remoti.

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));

Esempio completo di codice: Confronta file Excel tramite REST in C# usando GroupDocs.Comparison

Questo esempio dimostra come caricare due file XLSX, confrontarli e scaricare il risultato evidenziato.

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: Questo esempio di codice dimostra la funzionalità principale. Prima di usarlo nel tuo progetto, assicurati di aggiornare tutti i percorsi dei file e i valori di configurazione per corrispondere al tuo ambiente reale, verifica che tutte le dipendenze richieste siano installate correttamente e testa accuratamente nel tuo ambiente di sviluppo. Se incontri problemi, consulta la documentazione ufficiale o contatta il team di supporto per assistenza.

Chiamare l’API REST di Comparison con cURL

Di seguito è riportato un flusso di lavoro cURL che esegue la stessa operazione senza scrivere codice C#. Sostituisci i valori segnaposto con le tue credenziali effettive e i nomi dei file.

Ottenere un token di accesso

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"}'

Caricare il file XLSX di origine

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"

Caricare il file XLSX di destinazione

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"

Eseguire il confronto

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
           }
         }'

Scaricare il risultato

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

Per un elenco completo di endpoint e parametri, consultare la documentazione API ufficiale.

Prerequisiti e configurazione

Installa il pacchetto .NET tramite NuGet:

dotnet add package GroupDocs.Comparison-Cloud

Assicurati di avere un account GroupDocs Cloud valido e ottieni il tuo Client Id e Client Secret dalla dashboard.
.NET 6.0 o versioni successive sono richiesti.

Puoi scaricare l’ultima libreria dalla pagina di download.

Regolazione fine delle impostazioni di confronto

L’oggetto Settings all’interno di CompareOptions consente di controllare l’output. Le regolazioni comuni includono:

GenerateSummaryPage - aggiunge un foglio riepilogativo con le statistiche delle modifiche.
ShowDeletedContent - evidenzia le celle che sono state rimosse.
ShowInsertedContent - evidenzia le celle appena aggiunte.

Queste proprietà sono già utilizzate nell’esempio di codice sopra. Per opzioni aggiuntive come la protezione Password o StyleChangeDetection, fare riferimento al Riferimento API.

Conclusion

Confrontare file Excel tramite REST in C# diventa semplice con il GroupDocs.Comparison Cloud SDK for .NET. Seguendo i passaggi, è possibile caricare file XLSX, configurare impostazioni di confronto dettagliate, eseguire il confronto e recuperare una cartella di lavoro di risultato che evidenzia chiaramente le differenze. Ricorda di proteggere le credenziali API, rispettare i limiti di dimensione dei file e utilizzare una licenza temporanea per lo sviluppo. Quando sei pronto per la produzione, acquista una licenza completa dalla pricing page per sbloccare un utilizzo illimitato.

FAQ

Come posso confrontare file Excel tramite REST in C# usando GroupDocs.Comparison?
Utilizza l’SDK per caricare due file XLSX, imposta CompareOptions, chiama CompareDocument e scarica il file risultante. L’intero flusso di lavoro è illustrato nelle sezioni di codice e cURL sopra.
Quale metodo di autenticazione richiede l’API REST?
L’API utilizza OAuth 2.0 con il tuo client‑id e client‑secret per ottenere un token di accesso, che deve essere inviato nell’intestazione Authorization: Bearer per ogni richiesta.
Posso personalizzare quali modifiche sono evidenziate nel risultato del confronto?
Sì. Regola l’oggetto Settings (ad es., GenerateSummaryPage, ShowDeletedContent, ShowInsertedContent) per controllare l’aspetto delle differenze.
Una licenza temporanea è sufficiente per i test?
Una licenza temporanea dalla pagina della licenza temporanea funziona per lo sviluppo e i test. Per le distribuzioni in produzione, è necessario acquisire una licenza completa.

Confronta file Excel tramite REST in C#

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

Analizzare le modifiche tra versioni di fogli di calcolo è un compito di routine per i flussi di lavoro di finanza, reporting e convalida dei dati. GroupDocs.Comparison Cloud SDK for .NET fornisce un’API potente che rende facile confrontare i file Excel in .NET senza ispezione manuale. In questa guida vedrai come configurare la libreria, caricare le cartelle di lavoro, chiamare l’endpoint REST da C#, recuperare informazioni dettagliate sulle modifiche e perfezionare le opzioni di confronto per risultati precisi.

Prima di iniziare: requisiti e installazione

Prima di iniziare, assicurati di avere quanto segue:

.NET 6.0 o versioni successive installato.
Un IDE come Visual Studio 2022.
Un account GroupDocs Cloud con ClientId e ClientSecret.
Accesso allo storage GroupDocs Cloud dove verranno caricati i file Excel.

Installa l’SDK tramite NuGet:

dotnet add package GroupDocs.Comparison-Cloud

Scarica l’ultimo pacchetto dalla pagina di rilascio. Dopo l’installazione, aggiungi le tue credenziali nel codice come mostrato più avanti. Ora sei pronto per avviare il flusso di lavoro di confronto.

Guida passo-passo per confrontare file Excel in .NET

I seguenti passaggi illustrano come confrontare i file Excel in .NET utilizzando l’SDK.

Passo 1: Carica i documenti di origine e di destinazione

Crea un oggetto di configurazione con le tue credenziali e istanzia il CompareApi.

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

var compareApi = new CompareApi(config);

Passo 2: Preparare le cartelle di lavoro Excel

Definisci gli oggetti FileInfo che puntano ai file XLSX di origine e destinazione archiviati nello storage di GroupDocs Cloud.

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

Passo 3: Imposta le opzioni e le impostazioni di confronto

Configura l’oggetto CompareOptions, includendo le impostazioni dettagliate delle modifiche.

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
    }
};

Per un elenco completo delle impostazioni, consultare il riferimento API.

Passo 4: Esegui il confronto e elabora i risultati

Chiama il metodo Compare e leggi le informazioni di base sul risultato.

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

Passo 5: Recupera informazioni dettagliate sulle modifiche

Se hai bisogno di un report dettagliato, usa la richiesta 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}");

Con questi passaggi hai automatizzato completamente il processo di confronto dei file Excel in .NET.

Confrontare file Excel programmaticamente - Esempio di codice completo

Il codice seguente dimostra il flusso di lavoro completo dalla configurazione alla gestione del risultato.

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: Questo esempio di codice dimostra la funzionalità principale. Prima di usarlo nel tuo progetto, assicurati di aggiornare tutti i percorsi dei file e i valori di configurazione per corrispondere al tuo ambiente reale, verifica che tutte le dipendenze richieste siano installate correttamente e testa accuratamente nel tuo ambiente di sviluppo. Se incontri problemi, consulta la documentazione ufficiale o contatta il team di supporto per assistenza.

Esegui il confronto di Excel tramite REST con cURL

Puoi ottenere lo stesso risultato senza scrivere codice C# chiamando direttamente l’API REST.

1. Autenticare e Ottenere il Token di Accesso

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. Carica la cartella di lavoro di origine

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. Carica la cartella di lavoro di destinazione

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. Esegui il Confronto

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. Scarica la cartella di lavoro Diff risultante

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

Per un elenco completo dei parametri, consulta la documentazione ufficiale dell’API.

Conclusione

Utilizzando il GroupDocs.Comparison Cloud SDK for .NET è possibile confrontare facilmente i file Excel in .NET e ottenere una cartella di lavoro di diff dettagliata che evidenzia ogni modifica. L’architettura basata su REST del SDK consente di integrare il confronto di fogli di calcolo in qualsiasi servizio C#, API web o attività in background con il minimo sforzo. Ricorda di acquisire una licenza adeguata per l’uso in produzione; una licenza temporanea è disponibile dalla pagina della licenza e i dettagli completi della licenza sono elencati sul sito del prodotto. Inizia a automatizzare i tuoi flussi di lavoro di diff Excel oggi stesso e elimina gli errori di ispezione manuale.

FAQ

Come posso confrontare file Excel in .NET senza scrivere molto codice?
L’SDK astrae le operazioni complesse. È sufficiente configurare le credenziali, indicare i due file XLSX e chiamare compareApi.Compare. La libreria restituisce un file di diff e un elenco di oggetti di modifica.
Quale formato utilizza il risultato del diff?
Per impostazione predefinita il risultato viene salvato come cartella di lavoro XLSX, preservando il layout originale mentre vengono applicati indicatori visivi per cancellazioni, inserimenti e modifiche di stile.
È possibile confrontare cartelle di lavoro Excel protette?
Sì. Fornisci la password nella proprietà Password dell’oggetto FileInfo. L’API sbloccherà la cartella di lavoro prima di eseguire il confronto.
Ho bisogno di una licenza per sviluppo e test?
È possibile ottenere una licenza temporanea dalla pagina della licenza. Per le distribuzioni in produzione è necessario acquistare una licenza completa come descritto nella pagina del prodotto.

excel comparison on Document Processing REST APIs | GroupDocs Cloud

Confronta file Excel tramite REST in C#

Confronta file Excel tramite REST in C# in 5 passaggi

Esempio completo di codice: Confronta file Excel tramite REST in C# usando GroupDocs.Comparison

Chiamare l’API REST di Comparison con cURL

Prerequisiti e configurazione

Regolazione fine delle impostazioni di confronto

Conclusion

FAQ

Read More

Confronta file Excel tramite REST in C#

Prima di iniziare: requisiti e installazione

Guida passo-passo per confrontare file Excel in .NET

Passo 1: Carica i documenti di origine e di destinazione

Passo 2: Preparare le cartelle di lavoro Excel

Passo 3: Imposta le opzioni e le impostazioni di confronto

Passo 4: Esegui il confronto e elabora i risultati

Passo 5: Recupera informazioni dettagliate sulle modifiche

Confrontare file Excel programmaticamente - Esempio di codice completo

Esegui il confronto di Excel tramite REST con cURL

Conclusione

FAQ

Leggi di più