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 — true por defecto en cada constructor. Mientras sea true, no se carga ningún recurso externo excepto los que coincidan con WhitelistedResources o sean permitidos por el controlador.
  • WhitelistedResources — prefijos de URI absolutos de los recursos que se cargan mientras SkipExternalResources es true, por ejemplo https://cdn.example.com/assets/ o file:///C:/assets/. Vacío por defecto.
  • ExternalResourceHandler — null por defecto.

Cambios incompatibles hacia atrás:

  • Los recursos externos ya no se cargan por defecto. Los recursos remotos (http, https, ftp y 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 — URIs data:, referencias cid:, partes MHTML y medios empaquetados — sigue cargándose. Para cargar recursos externos, incluya sus ubicaciones en la lista blanca o establezca SkipExternalResources en false para los documentos en los que confíe.
  • LoadOptions ahora es sealed. Una clase derivada de ella ya no compila. Use LoadOptions directamente, o implemente ILoadOptions; una implementación personalizada de ILoadOptions que no implemente también IResourceLoadingOptions obtiene la política predeterminada.
  • Una entrada de WhitelistedResources que sea nula, vacía, no sea una URI absoluta, contenga una consulta o fragmento, o incluya %2F, %5C o %2E hace que el constructor de Merger lance ArgumentException (“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 como InnerException.
  • 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, OleSpreadsheetOptions y OleWordProcessingOptions que 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 permita LoadOptions del documento objetivo. Para mostrarlos, pase sus propios datos de imagen al constructor que los acepta.
  • Los productos del paquete GroupDocs.Merger.LowCode siempre 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, JoinPptx y RemovePagesPdf resuelven 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 lanza ArgumentNullException.
  • JoinPdf, JoinDocx y JoinPptx lanzan FileTypeNotSupportedException cuando 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)’.”. Antes JoinPdf y JoinDocx producían salida mixta y JoinPptx fallaba más tarde con otro mensaje. Una ruta de documento unido nula o vacía lanza ArgumentNullException (“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 de ArgumentException.

5. Dependencias

  • Los paquetes de tiempo de ejecución dependen de System.Security.Cryptography.Pkcs 8.0.2 (GroupDocs.Merger.Net60, GroupDocs.Merger.Net80 y sus paquetes .Windows) o 9.0.21 (GroupDocs.Merger.Net100 y GroupDocs.Merger.Net100.Windows). GroupDocs.Merger.Net60, GroupDocs.Merger.Net60.Windows y GroupDocs.Merger.LowCode también dependen de System.Formats.Asn1 8.0.2, y GroupDocs.Merger.LowCode de System.Security.Cryptography.Pkcs 8.0.2. GroupDocs.Merger.Net462 no ha cambiado.
  • En proyectos .NET Framework, el paquete GroupDocs.Merger ya no agrega una redirección de enlace para System.ValueTuple en app.config o web.config (proyectos con packages.config), y sus compilaciones para .NET Framework establecen DependsOnNETStandard en true a 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. LoadOptions incluye las nuevas propiedades SkipExternalResources, WhitelistedResources y ExternalResourceHandler para 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 NullReferenceException o IndexOutOfRangeException, y los documentos TeX ya no lanzan ArgumentException cuando 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 .ncx ya no fallan con NullReferenceException.
  • 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, JoinDocx y JoinPptx rechazan 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.

Recursos