Siamo felici di annunciare il rilascio di GroupDocs.Merger for .NET v26.10, disponibile a partire da ottobre 2026. Questa versione introduce importanti miglioramenti per il controllo del caricamento delle risorse esterne, risolve problemi critici di concorrenza nell’elaborazione di EPUB e TeX, migliora l’impaginazione degli EPUB, preserva il formato PDF e il titolo nell’output con auto‑tagging e corregge diversi errori legati a .NET Framework. In totale, include 10 funzionalità, miglioramenti e correzioni di bug.

Novità di questa versione

  • [Feature] Salta il caricamento delle risorse esterne per impostazione predefinita, con una whitelist di posizioni attendibili e un gestore per risorsa
  • [Bug] Corregge NullReferenceException per i documenti EPUB il cui file di indice non ha l’estensione .ncx
  • [Bug] Corregge le unioni di immagini che non riuscivano a caricare System.ValueTuple nei progetti .NET Framework packages.config
  • [Bug] Corregge le unioni con documenti SVG che fallivano su runtime .NET Framework 4.6.2‑4.7.0
  • [Bug] Rende le pagine EPUB a layout fisso una per pagina del libro invece di dividerle in due
  • [Bug] Aggiorna System.Security.Cryptography.Pkcs a 8.0.2 e 9.0.21 (CVE-2026-84008, CVE-2026-70162)
  • [Bug] Mantiene il formato PDF originale e il titolo quando si salva con l’auto‑tagging abilitato
  • [Bug] Corregge un ArgumentException quando i documenti TeX vengono caricati in modo concorrente
  • [Bug] Salva l’output LowCode fornito come nome file semplice nella directory corrente e rifiuta documenti uniti di formato diverso
  • [Bug] Corregge i documenti EPUB che occasionalmente fallivano con NullReferenceException o IndexOutOfRangeException quando elaborati in modo concorrente

Modifiche all’API pubblica

1. Risorse esterne — negate per impostazione predefinita (nuova API, incompatibile retroattivamente)

Nuovi tipi pubblici nello spazio dei nomi GroupDocs.Merger.Domain.Options:

Tipo Descrizione
IResourceLoadingOptions Definisce SkipExternalResources, WhitelistedResources e ExternalResourceHandler. LoadOptions lo implementa.
IExternalResourceHandler Il suo metodo OnLoading viene chiamato per ogni risorsa esterna prima del caricamento e può consentire, saltare o sostituirla.
ExternalResourceLoadingArgs La risorsa passata a OnLoading: Uri, Skipped (preimpostato in base alla decisione delle altre due opzioni) e Data (contenuto da usare al posto del caricamento della risorsa).

Nuove proprietà di LoadOptions:

  • SkipExternalResources — true per impostazione predefinita in ogni costruttore. Quando è true, nessuna risorsa esterna viene caricata eccetto quelle che corrispondono a WhitelistedResources o sono consentite dal gestore.
  • WhitelistedResources — prefissi URI assoluti delle risorse che vengono caricate mentre SkipExternalResources è true, ad esempio https://cdn.example.com/assets/ o file:///C:/assets/. Vuoto per impostazione predefinita.
  • ExternalResourceHandler — null per impostazione predefinita.

Modifiche incompatibili retroattivamente:

  • Le risorse esterne non vengono più caricate per impostazione predefinita. Le risorse remote (http, https, ftp e altri schemi), percorsi UNC, file locali, inclusi i file nella cartella del documento, e riferimenti relativi che puntano fuori dal documento vengono ignorati e l’operazione continua. Le versioni precedenti le caricavano. Di conseguenza, immagini remote e fogli di stile di documenti HTML, Word e presentazione possono mancare nell’output e il conteggio delle pagine di documenti HTML e Word può variare. Il contenuto che il documento contiene — URI data:, riferimenti cid:, parti MHTML e media confezionati — viene comunque caricato. Per caricare risorse esterne, aggiungi le loro posizioni alla whitelist o imposta SkipExternalResources a false per i documenti di cui ti fidi.
  • LoadOptions è ora sealed. Una classe derivata non compila più. Usa LoadOptions direttamente, oppure implementa ILoadOptions; un’implementazione personalizzata di ILoadOptions che non implementa anche IResourceLoadingOptions ottiene la politica predefinita.
  • Una voce WhitelistedResources che è null, vuota, non è un URI assoluto, contiene una query o un frammento, o contiene %2F, %5C o %2E fa sì che il costruttore Merger lanci ArgumentException (“Whitelisted resource ‘…’ must be an absolute URI without a query, fragment or encoded ‘/’, ‘\’ or ‘.’.”).
  • Se il gestore lancia un’eccezione, la risorsa viene saltata e l’operazione lancia GroupDocsMergerException (“The external resource handler threw an exception; the resource was skipped. See the inner exception.”) con l’eccezione del gestore come InnerException.
  • I documenti EPUB, e i documenti SVG e SVGZ in alcune operazioni, ora hanno il loro markup controllato per riferimenti esterni. Un documento il cui markup non è XML ben formato fallisce con GroupDocsMergerException (“The document’s markup could not be read to check it for external resources, so it was not loaded. Set SkipExternalResources to false without an ExternalResourceHandler to load it without the check.”).
  • I costruttori OleDiagramOptions, OleSpreadsheetOptions e OleWordProcessingOptions che accettano un percorso file e un numero di pagina rendono l’immagine dell’oggetto incorporato con risorse esterne negate, indipendentemente da ciò che le LoadOptions del documento di destinazione consentono. Per visualizzarle, passa i tuoi dati immagine al costruttore che li accetta.
  • I prodotti del pacchetto GroupDocs.Merger.LowCode negano sempre le risorse esterne.

Le opzioni vengono lette quando viene creato il Merger, e i documenti uniti ad esso seguono le sue opzioni.

2. I documenti PDF auto‑taggati mantengono il formato e il titolo della sorgente

Nessuna modifica all’API. Un documento PDF salvato con PdfSaveOptions.AccesibilitySettings.EnableAutoTagging impostato a true mantiene il formato PDF e il titolo della sorgente. In precedenza ogni documento auto‑taggato era contrassegnato come PDF/UA-1, e una sorgente senza titolo otteneva il titolo “Tagged PDF”. L’auto‑tagging aggiunge un albero di struttura logica; non rende il documento conforme a PDF/UA, e una sorgente già contrassegnata come PDF/UA mantiene il suo marchio.

3. Documenti EPUB a layout fisso — una pagina per pagina del libro

Nessuna modifica all’API. Un documento EPUB a layout fisso ora ha una pagina per pagina del libro. In precedenza ogni pagina del libro veniva resa come due pagine, quindi GetDocumentInfo riportava il doppio del conteggio delle pagine e la pagina N non corrispondeva alla pagina N del libro. I numeri di pagina passati alle operazioni di pagina come ExtractPages, RemovePages o Split ora si riferiscono alle pagine del libro.

4. GroupDocs.Merger.LowCode — percorso di output e documenti uniti

  • JoinPdf, JoinDocx, JoinPptx e RemovePagesPdf risolvono un percorso di output relativo rispetto alla directory di lavoro corrente. Un percorso di output fornito come nome file semplice ora viene salvato nella directory corrente; in precedenza veniva salvato nella directory di output predefinita di Merger. Un percorso di output null o vuoto lancia ArgumentNullException.
  • JoinPdf, JoinDocx e JoinPptx lanciano FileTypeNotSupportedException quando l’estensione di un documento unito non corrisponde al formato del prodotto, prima che venga scritto qualsiasi output, ad esempio “Input format does not match the expected format ‘PDF’; the joined file ‘a.docx’ is ‘Microsoft Word Open XML Document (.docx)’.”. In precedenza JoinPdf e JoinDocx producevano output misti e JoinPptx falliva più tardi con un altro messaggio. Un percorso di documento unito null o vuoto lancia ArgumentNullException (“The document at index 0 is null or empty.”).
  • Tutti e sette i prodotti lanciano FileTypeNotSupportedException (“Input format does not match the expected format ‘PDF’; the supplied file is ‘Unknown’.”) per un percorso sorgente senza estensione, invece di ArgumentException.

5. Dipendenze

  • I pacchetti runtime dipendono da System.Security.Cryptography.Pkcs 8.0.2 (GroupDocs.Merger.Net60, GroupDocs.Merger.Net80 e i loro pacchetti .Windows) o 9.0.21 (GroupDocs.Merger.Net100 e GroupDocs.Merger.Net100.Windows). GroupDocs.Merger.Net60, GroupDocs.Merger.Net60.Windows e GroupDocs.Merger.LowCode dipendono anche da System.Formats.Asn1 8.0.2, e GroupDocs.Merger.LowCode da System.Security.Cryptography.Pkcs 8.0.2. GroupDocs.Merger.Net462 rimane invariato.
  • Nei progetti .NET Framework, il pacchetto GroupDocs.Merger non aggiunge più un binding redirect per System.ValueTuple a app.config o web.config (progetti packages.config), e i suoi target di build .NET Framework impostano DependsOnNETStandard a true a meno che il progetto non lo imposti.

Nuove funzionalità

  • Controllo delle risorse esterne: Immagini remote, fogli di stile, immagini collegate e altri file a cui un documento fa riferimento non vengono più caricati a meno che non li consenti. LoadOptions ha nuove proprietà SkipExternalResources, WhitelistedResources e ExternalResourceHandler per consentire posizioni attendibili, consentire tutto per i documenti di cui ti fidi, o decidere, saltare o fornire ogni risorsa nel tuo codice.
  • Correzioni di concorrenza: I documenti EPUB non falliscono più occasionalmente con NullReferenceException o IndexOutOfRangeException, e i documenti TeX con ArgumentException, quando vengono elaborati da più thread.
  • Documenti EPUB: I documenti EPUB a layout fisso ora hanno una pagina per pagina del libro, quindi la pagina N è la pagina N del libro. I documenti EPUB il cui file di indice ha un’estensione diversa da .ncx non falliscono più con NullReferenceException.
  • Output PDF auto‑taggato: Un documento PDF salvato con auto‑tagging mantiene il formato e il titolo della sorgente. Non è più contrassegnato come PDF/UA-1 a meno che la sorgente non lo fosse, e una sorgente senza titolo non ottiene più il titolo “Tagged PDF”.
  • Progetti .NET Framework: Le unioni di immagini nei progetti packages.config non falliscono più nel caricare System.ValueTuple, e le unioni con documenti SVG non falliscono più nel caricare netstandard su runtime .NET Framework 4.6.2‑4.7.0.
  • Dipendenza corretta: I pacchetti dipendono da System.Security.Cryptography.Pkcs 8.0.2 (.NET 6.0 e .NET 8.0) o 9.0.21 (.NET 10.0), le versioni che risolvono CVE-2026-84008 e CVE-2026-70162.
  • Prodotti LowCode: Un percorso di output fornito come nome file semplice viene salvato nella directory corrente, e JoinPdf, JoinDocx e JoinPptx rifiutano un documento unito di formato diverso prima che venga scritto qualsiasi output.

Esempio di codice

using System.Collections.Generic;
using GroupDocs.Merger;
using GroupDocs.Merger.Domain;
using GroupDocs.Merger.Domain.Options;

var loadOptions = new LoadOptions(FileType.HTML)
{
    // Load resources from one trusted folder only; everything else stays denied
    WhitelistedResources = new List<string> { "https://cdn.example.com/assets/" }
};

using (var merger = new Merger("page1.html", loadOptions))
{
    merger.Join("page2.html");
    merger.Save("merged.html");
}
using System;
using GroupDocs.Merger.Domain.Options;

public class TrustedPngHandler : IExternalResourceHandler
{
    public void OnLoading(ExternalResourceLoadingArgs args)
    {
        Uri uri;
        if (Uri.TryCreate(args.Uri, UriKind.Absolute, out uri)
            && uri.Scheme == Uri.UriSchemeHttps
            && uri.Host == "cdn.example.com"
            && uri.AbsolutePath.EndsWith(".png", StringComparison.OrdinalIgnoreCase))
        {
            args.Skipped = false;   // allow; any other resource keeps the default decision
        }
    }
}

Come ottenere l’aggiornamento

NuGet

Aggiorna all’ultimo pacchetto GroupDocs.Merger tramite NuGet: GroupDocs.Merger 26.10.0

dotnet add package GroupDocs.Merger --version 26.10.0

Download diretto

Scarica gli assembly dalla pagina GroupDocs.Merger for .NET 26.10 .

Risorse