Nos complace anunciar el lanzamiento de GroupDocs.Merger for .NET v26.10, disponible a partir de octubre de 2026. Esta versión introduce mejoras importantes para controlar la carga de recursos externos, resuelve problemas críticos de concurrencia en el procesamiento de EPUB y TeX, mejora la paginación de EPUB, conserva el formato y el título del PDF en la salida con autoetiquetado y corrige varios fallos relacionados con .NET Framework. En total, incluye 10 características, mejoras y correcciones de errores.
Qué hay de nuevo en esta versión
- [Feature] Omitir la carga de recursos externos por defecto, con una lista blanca de ubicaciones de confianza y un controlador por recurso
- [Bug] Corregir NullReferenceException para documentos EPUB cuyo archivo de tabla de contenido no tiene la extensión .ncx
- [Bug] Corregir fallos en la unión de imágenes que no cargaban System.ValueTuple en proyectos .NET Framework con packages.config
- [Bug] Corregir fallos en la unión con documentos SVG en entornos .NET Framework 4.6.2 a 4.7.0
- [Bug] Renderizar páginas EPUB de diseño fijo una por página del libro en lugar de dividir cada una en dos
- [Bug] Actualizar System.Security.Cryptography.Pkcs a 8.0.2 y 9.0.21 (CVE-2026-84008, CVE-2026-70162)
- [Bug] Mantener el formato PDF original y el título al guardar con autoetiquetado habilitado
- [Bug] Corregir ArgumentException cuando los documentos TeX se cargan concurrentemente
- [Bug] Guardar la salida de LowCode proporcionada como un nombre de archivo simple en el directorio actual y rechazar documentos unidos de otro formato
- [Bug] Corregir fallos intermitentes en documentos EPUB con NullReferenceException o IndexOutOfRangeException al procesarse concurrentemente
Cambios en la API pública
1. Recursos externos — denegados por defecto (nueva API, incompatibilidad hacia atrás)
Nuevos tipos públicos en el espacio de nombres GroupDocs.Merger.Domain.Options:
| Tipo | Descripción |
|---|---|
| IResourceLoadingOptions | Define SkipExternalResources, WhitelistedResources y ExternalResourceHandler. LoadOptions lo implementa. |
| IExternalResourceHandler | Su método OnLoading se llama para cada recurso externo antes de cargarlo y puede permitir, omitir o reemplazarlo. |
| ExternalResourceLoadingArgs | El recurso pasado a OnLoading: Uri, Skipped (preestablecido según la decisión de las otras dos opciones) y Data (contenido a usar en lugar de cargar el recurso). |
Nuevas propiedades de LoadOptions:
SkipExternalResources—truepor defecto en cada constructor. Mientras seatrue, no se carga ningún recurso externo excepto los que coincidan conWhitelistedResourceso sean permitidos por el controlador.WhitelistedResources— prefijos de URI absolutos de los recursos que se cargan mientrasSkipExternalResourcesestrue, por ejemplohttps://cdn.example.com/assets/ofile:///C:/assets/. Vacío por defecto.ExternalResourceHandler—nullpor defecto.
Cambios incompatibles hacia atrás:
- Los recursos externos ya no se cargan por defecto. Los recursos remotos (
http,https,ftpy otros esquemas), rutas UNC, archivos locales, incluidos los archivos en la propia carpeta del documento, y referencias relativas que apunten fuera del documento se omiten y la operación continúa. Las versiones anteriores los cargaban. Por lo tanto, imágenes y hojas de estilo remotas de documentos HTML, Word y presentaciones pueden faltar en la salida, y el recuento de páginas de documentos HTML y Word puede cambiar. El contenido que lleva el documento — URIsdata:, referenciascid:, partes MHTML y medios empaquetados — sigue cargándose. Para cargar recursos externos, incluya sus ubicaciones en la lista blanca o establezcaSkipExternalResourcesenfalsepara los documentos en los que confíe. LoadOptionsahora essealed. Una clase derivada de ella ya no compila. UseLoadOptionsdirectamente, o implementeILoadOptions; una implementación personalizada deILoadOptionsque no implemente tambiénIResourceLoadingOptionsobtiene la política predeterminada.- Una entrada de
WhitelistedResourcesque sea nula, vacía, no sea una URI absoluta, contenga una consulta o fragmento, o incluya%2F,%5Co%2Ehace que el constructor deMergerlanceArgumentException(“Whitelisted resource ‘…’ must be an absolute URI without a query, fragment or encoded ‘/’, ‘\’ or ‘.’.”). - Si el controlador lanza una excepción, el recurso se omite y la operación lanza
GroupDocsMergerException(“The external resource handler threw an exception; the resource was skipped. See the inner exception.”) con la excepción del controlador comoInnerException. - Los documentos EPUB, y los documentos SVG y SVGZ en algunas operaciones, ahora tienen su marcado verificado en busca de referencias externas. Un documento cuyo marcado no sea XML bien formado falla 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.”). - Los constructores
OleDiagramOptions,OleSpreadsheetOptionsyOleWordProcessingOptionsque reciben una ruta de archivo y un número de página renderizan la imagen del objeto incrustado con recursos externos denegados, sin importar lo que permitaLoadOptionsdel documento objetivo. Para mostrarlos, pase sus propios datos de imagen al constructor que los acepta. - Los productos del paquete
GroupDocs.Merger.LowCodesiempre deniegan recursos externos.
Las opciones se leen cuando se crea el Merger, y los documentos que se unen a él siguen esas opciones.
2. Los documentos PDF autoetiquetados conservan el formato y el título del origen
Sin cambio de API. Un documento PDF guardado con PdfSaveOptions.AccesibilitySettings.EnableAutoTagging establecido en true conserva el formato PDF y el título del origen. Anteriormente, todo documento autoetiquetado se marcaba como PDF/UA-1, y una fuente sin título recibía el título “Tagged PDF”. El autoetiquetado agrega un árbol de estructura lógica; no hace que el documento sea compatible con PDF/UA, y una fuente que ya está marcada como PDF/UA conserva su marca.
3. Documentos EPUB de diseño fijo — una página por página del libro
Sin cambio de API. Un documento EPUB de diseño fijo ahora tiene una página por página del libro. Antes, cada página del libro se renderizaba como dos páginas, por lo que GetDocumentInfo informaba el doble del recuento de páginas y la página N no coincidía con la página N del libro. Los números de página pasados a operaciones como ExtractPages, RemovePages o Split ahora se refieren a las páginas del libro.
4. GroupDocs.Merger.LowCode — ruta de salida y documentos unidos
JoinPdf,JoinDocx,JoinPptxyRemovePagesPdfresuelven una ruta de salida relativa contra el directorio de trabajo actual. Una ruta de salida proporcionada como un nombre de archivo simple ahora se guarda en el directorio actual; antes se guardaba en el directorio de salida predeterminado de Merger. Una ruta de salida nula o vacía lanzaArgumentNullException.JoinPdf,JoinDocxyJoinPptxlanzanFileTypeNotSupportedExceptioncuando la extensión de un documento unido no coincide con el formato del producto, antes de que se escriba cualquier salida, por ejemplo “Input format does not match the expected format ‘PDF’; the joined file ‘a.docx’ is ‘Microsoft Word Open XML Document (.docx)’.”. AntesJoinPdfyJoinDocxproducían salida mixta yJoinPptxfallaba más tarde con otro mensaje. Una ruta de documento unido nula o vacía lanzaArgumentNullException(“The document at index 0 is null or empty.”).- Los siete productos lanzan
FileTypeNotSupportedException(“Input format does not match the expected format ‘PDF’; the supplied file is ‘Unknown’.”) para una ruta de origen sin extensión, en lugar deArgumentException.
5. Dependencias
- Los paquetes de tiempo de ejecución dependen de System.Security.Cryptography.Pkcs 8.0.2 (
GroupDocs.Merger.Net60,GroupDocs.Merger.Net80y sus paquetes.Windows) o 9.0.21 (GroupDocs.Merger.Net100yGroupDocs.Merger.Net100.Windows).GroupDocs.Merger.Net60,GroupDocs.Merger.Net60.WindowsyGroupDocs.Merger.LowCodetambién dependen de System.Formats.Asn1 8.0.2, yGroupDocs.Merger.LowCodede System.Security.Cryptography.Pkcs 8.0.2.GroupDocs.Merger.Net462no ha cambiado. - En proyectos .NET Framework, el paquete
GroupDocs.Mergerya no agrega una redirección de enlace para System.ValueTuple enapp.configoweb.config(proyectos con packages.config), y sus compilaciones para .NET Framework establecenDependsOnNETStandardentruea menos que el proyecto lo configure explícitamente.
Nuevas características
- Control de recursos externos: Las imágenes remotas, hojas de estilo, imágenes vinculadas y otros archivos que un documento referencia ya no se cargan a menos que los permita.
LoadOptionsincluye las nuevas propiedadesSkipExternalResources,WhitelistedResourcesyExternalResourceHandlerpara permitir ubicaciones de confianza, permitir todo para documentos en los que confíe, o decidir, omitir o suministrar cada recurso en su propio código. - Correcciones de concurrencia: Los documentos EPUB ya no fallan intermitentemente con
NullReferenceExceptionoIndexOutOfRangeException, y los documentos TeX ya no lanzanArgumentExceptioncuando se procesan desde varios hilos. - Documentos EPUB: Los documentos EPUB de diseño fijo ahora tienen una página por página del libro, de modo que la página N corresponde a la página N del libro. Los documentos EPUB cuyo archivo de tabla de contenido tiene una extensión distinta a
.ncxya no fallan conNullReferenceException. - Salida PDF autoetiquetada: Un documento PDF guardado con autoetiquetado conserva el formato y el título del origen. Ya no se marca como PDF/UA-1 a menos que el origen lo estuviera, y una fuente sin título ya no recibe el título “Tagged PDF”.
- Proyectos .NET Framework: Las uniones de imágenes en proyectos con packages.config ya no fallan al cargar System.ValueTuple, y las uniones con documentos SVG ya no fallan al cargar netstandard en entornos .NET Framework 4.6.2 a 4.7.0.
- Dependencia parcheada: Los paquetes dependen de System.Security.Cryptography.Pkcs 8.0.2 (.NET 6.0 y .NET 8.0) o 9.0.21 (.NET 10.0), versiones que corrigen CVE-2026-84008 y CVE-2026-70162.
- Productos LowCode: Una ruta de salida proporcionada como un nombre de archivo simple se guarda en el directorio actual, y
JoinPdf,JoinDocxyJoinPptxrechazan un documento unido de otro formato antes de que se escriba cualquier salida.
Ejemplo de código
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
}
}
}
Cómo obtener la actualización
NuGet
Actualice al último paquete GroupDocs.Merger a través de NuGet: GroupDocs.Merger 26.10.0
dotnet add package GroupDocs.Merger --version 26.10.0
Descarga directa
Descargue los ensamblados desde la página GroupDocs.Merger for .NET 26.10.