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—trueper impostazione predefinita in ogni costruttore. Quando ètrue, nessuna risorsa esterna viene caricata eccetto quelle che corrispondono aWhitelistedResourceso sono consentite dal gestore.WhitelistedResources— prefissi URI assoluti delle risorse che vengono caricate mentreSkipExternalResourcesètrue, ad esempiohttps://cdn.example.com/assets/ofile:///C:/assets/. Vuoto per impostazione predefinita.ExternalResourceHandler—nullper impostazione predefinita.
Modifiche incompatibili retroattivamente:
- Le risorse esterne non vengono più caricate per impostazione predefinita. Le risorse remote (
http,https,ftpe 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 — URIdata:, riferimenticid:, parti MHTML e media confezionati — viene comunque caricato. Per caricare risorse esterne, aggiungi le loro posizioni alla whitelist o impostaSkipExternalResourcesafalseper i documenti di cui ti fidi. LoadOptionsè orasealed. Una classe derivata non compila più. UsaLoadOptionsdirettamente, oppure implementaILoadOptions; un’implementazione personalizzata diILoadOptionsche non implementa ancheIResourceLoadingOptionsottiene la politica predefinita.- Una voce
WhitelistedResourcesche è null, vuota, non è un URI assoluto, contiene una query o un frammento, o contiene%2F,%5Co%2Efa sì che il costruttoreMergerlanciArgumentException(“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 comeInnerException. - 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,OleSpreadsheetOptionseOleWordProcessingOptionsche accettano un percorso file e un numero di pagina rendono l’immagine dell’oggetto incorporato con risorse esterne negate, indipendentemente da ciò che leLoadOptionsdel documento di destinazione consentono. Per visualizzarle, passa i tuoi dati immagine al costruttore che li accetta. - I prodotti del pacchetto
GroupDocs.Merger.LowCodenegano 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,JoinPptxeRemovePagesPdfrisolvono 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 lanciaArgumentNullException.JoinPdf,JoinDocxeJoinPptxlancianoFileTypeNotSupportedExceptionquando 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 precedenzaJoinPdfeJoinDocxproducevano output misti eJoinPptxfalliva più tardi con un altro messaggio. Un percorso di documento unito null o vuoto lanciaArgumentNullException(“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 diArgumentException.
5. Dipendenze
- I pacchetti runtime dipendono da System.Security.Cryptography.Pkcs 8.0.2 (
GroupDocs.Merger.Net60,GroupDocs.Merger.Net80e i loro pacchetti.Windows) o 9.0.21 (GroupDocs.Merger.Net100eGroupDocs.Merger.Net100.Windows).GroupDocs.Merger.Net60,GroupDocs.Merger.Net60.WindowseGroupDocs.Merger.LowCodedipendono anche da System.Formats.Asn1 8.0.2, eGroupDocs.Merger.LowCodeda System.Security.Cryptography.Pkcs 8.0.2.GroupDocs.Merger.Net462rimane invariato. - Nei progetti .NET Framework, il pacchetto
GroupDocs.Mergernon aggiunge più un binding redirect per System.ValueTuple aapp.configoweb.config(progetti packages.config), e i suoi target di build .NET Framework impostanoDependsOnNETStandardatruea 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.
LoadOptionsha nuove proprietàSkipExternalResources,WhitelistedResourceseExternalResourceHandlerper 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
NullReferenceExceptionoIndexOutOfRangeException, e i documenti TeX conArgumentException, 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
.ncxnon falliscono più conNullReferenceException. - 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,JoinDocxeJoinPptxrifiutano 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 .