Temos o prazer de anunciar o lançamento do GroupDocs.Merger for .NET v26.10, disponível a partir de outubro de 2026. Esta versão introduz melhorias importantes para o controle do carregamento de recursos externos, resolve problemas críticos de concorrência no processamento de EPUB e TeX, melhora a paginação de EPUB, preserva o formato e o título do PDF na saída com auto‑tagging e corrige várias falhas relacionadas ao .NET Framework. No total, inclui 10 recursos, melhorias e correções de bugs.
Novidades nesta versão
- [Feature] Ignorar o carregamento de recursos externos por padrão, com uma lista branca de locais confiáveis e um manipulador por recurso
- [Bug] Corrigir NullReferenceException para documentos EPUB cujo arquivo de índice não tem a extensão .ncx
- [Bug] Corrigir junções de imagens que falham ao carregar System.ValueTuple em projetos .NET Framework packages.config
- [Bug] Corrigir junções com documentos SVG que falham em tempos de execução .NET Framework 4.6.2 a 4.7.0
- [Bug] Renderizar páginas EPUB de layout fixo uma por página do livro em vez de dividir cada uma em duas
- [Bug] Atualizar System.Security.Cryptography.Pkcs para 8.0.2 e 9.0.21 (CVE-2026-84008, CVE-2026-70162)
- [Bug] Manter o formato PDF original e o título ao salvar com auto‑tagging habilitado
- [Bug] Corrigir ArgumentException ao carregar documentos TeX simultaneamente
- [Bug] Salvar a saída LowCode fornecida como um nome de arquivo simples no diretório atual e rejeitar documentos juntados de outro formato
- [Bug] Corrigir documentos EPUB que falham intermitentemente com NullReferenceException ou IndexOutOfRangeException quando processados simultaneamente
Alterações na API Pública
1. Recursos externos — negados por padrão (nova API, incompatível retroativamente)
Novos tipos públicos no namespace GroupDocs.Merger.Domain.Options:
| Tipo | Descrição |
|---|---|
| IResourceLoadingOptions | Define SkipExternalResources, WhitelistedResources e ExternalResourceHandler. LoadOptions o implementa. |
| IExternalResourceHandler | Seu método OnLoading é chamado para cada recurso externo antes de ser carregado e pode permitir, pular ou substituí‑lo. |
| ExternalResourceLoadingArgs | O recurso passado para OnLoading: Uri, Skipped (pré‑definido com a decisão das outras duas opções) e Data (conteúdo a ser usado em vez de carregar o recurso). |
Novas propriedades de LoadOptions:
SkipExternalResources—truepor padrão em todo construtor. Enquantotrue, nenhum recurso externo é carregado exceto aqueles que correspondem aWhitelistedResourcesou são permitidos pelo manipulador.WhitelistedResources— prefixos de URI absolutos dos recursos que são carregados enquantoSkipExternalResourcesfortrue, por exemplohttps://cdn.example.com/assets/oufile:///C:/assets/. Vazio por padrão.ExternalResourceHandler—nullpor padrão.
Mudanças incompatíveis retroativamente:
- Recursos externos não são mais carregados por padrão. Recursos remotos (
http,https,ftpe outros esquemas), caminhos UNC, arquivos locais, incluindo arquivos na própria pasta do documento, e referências relativas que apontam fora do documento são ignorados, e a operação continua. Versões anteriores os carregavam. Imagens remotas e folhas de estilo de documentos HTML, Word e apresentações podem, portanto, estar ausentes na saída, e a contagem de páginas de documentos HTML e Word pode mudar. O conteúdo que o documento contém — URIsdata:, referênciascid:, partes MHTML e mídia empacotada — ainda é carregado. Para carregar recursos externos, inclua suas localizações na lista branca ou definaSkipExternalResourcescomofalsepara documentos em que confia. LoadOptionsagora ésealed. Uma classe derivada dele não compila mais. UseLoadOptionsdiretamente, ou implementeILoadOptions; uma implementação personalizada deILoadOptionsque não implemente tambémIResourceLoadingOptionsrecebe a política padrão.- Uma entrada
WhitelistedResourcesque seja nula, vazia, não seja uma URI absoluta, contenha uma consulta ou fragmento, ou contenha%2F,%5Cou%2Efaz o construtorMergerlançarArgumentException(“Whitelisted resource ‘…’ must be an absolute URI without a query, fragment or encoded ‘/’, ‘\’ or ‘.’.”). - Se o manipulador lançar uma exceção, o recurso é ignorado e a operação lança
GroupDocsMergerException(“The external resource handler threw an exception; the resource was skipped. See the inner exception.”) com a exceção do manipulador comoInnerException. - Documentos EPUB, e documentos SVG e SVGZ em algumas operações, agora têm sua marcação verificada quanto a referências externas. Um documento cuja marcação não seja XML bem‑formado falha com
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.”). - Os construtores
OleDiagramOptions,OleSpreadsheetOptionseOleWordProcessingOptionsque recebem um caminho de arquivo e um número de página renderizam a imagem do objeto incorporado com recursos externos negados, independentemente do queLoadOptionsdo documento de destino permita. Para exibi‑los, passe seus próprios dados de imagem ao construtor que os aceita. - Os produtos do pacote
GroupDocs.Merger.LowCodesempre negam recursos externos.
As opções são lidas quando o Merger é criado, e os documentos juntados a ele seguem suas opções.
2. Documentos PDF com auto‑tagging mantêm o formato e o título da origem
Sem mudança na API. Um documento PDF salvo com PdfSaveOptions.AccesibilitySettings.EnableAutoTagging definido como true mantém o formato PDF e o título da origem. Anteriormente, todo documento com auto‑tagging era marcado como PDF/UA-1, e uma origem sem título recebia o título “Tagged PDF”. O auto‑tagging adiciona uma árvore de estrutura lógica; não torna o documento compatível com PDF/UA, e uma origem que já está marcada como PDF/UA mantém sua marca.
3. Documentos EPUB de layout fixo — uma página por página do livro
Sem mudança na API. Um documento EPUB de layout fixo agora tem uma página por página do livro. Anteriormente, cada página do livro era renderizada como duas páginas, de modo que GetDocumentInfo relatava o dobro da contagem de páginas e a página N não correspondia à página N do livro. Os números de página passados para operações de página como ExtractPages, RemovePages ou Split agora referem‑se às páginas do livro.
4. GroupDocs.Merger.LowCode — caminho de saída e documentos juntados
JoinPdf,JoinDocx,JoinPptxeRemovePagesPdfresolvem um caminho de saída relativo em relação ao diretório de trabalho atual. Um caminho de saída fornecido como um nome de arquivo simples agora é salvo no diretório atual; anteriormente era salvo no diretório de saída padrão do Merger. Um caminho de saída nulo ou vazio lançaArgumentNullException.JoinPdf,JoinDocxeJoinPptxlançamFileTypeNotSupportedExceptionquando a extensão de um documento juntado não corresponde ao formato do produto, antes que qualquer saída seja escrita, por exemplo “Input format does not match the expected format ‘PDF’; the joined file ‘a.docx’ is ‘Microsoft Word Open XML Document (.docx)’.”. AnteriormenteJoinPdfeJoinDocxproduziam saída mista eJoinPptxfalhava mais tarde com outra mensagem. Um caminho de documento juntado nulo ou vazio lançaArgumentNullException(“The document at index 0 is null or empty.”).- Todos os sete produtos lançam
FileTypeNotSupportedException(“Input format does not match the expected format ‘PDF’; the supplied file is ‘Unknown’.”) para um caminho de origem sem extensão, em vez deArgumentException.
5. Dependências
- Os pacotes de tempo de execução dependem de System.Security.Cryptography.Pkcs 8.0.2 (
GroupDocs.Merger.Net60,GroupDocs.Merger.Net80e seus pacotes.Windows) ou 9.0.21 (GroupDocs.Merger.Net100eGroupDocs.Merger.Net100.Windows).GroupDocs.Merger.Net60,GroupDocs.Merger.Net60.WindowseGroupDocs.Merger.LowCodetambém dependem de System.Formats.Asn1 8.0.2, eGroupDocs.Merger.LowCodede System.Security.Cryptography.Pkcs 8.0.2.GroupDocs.Merger.Net462permanece inalterado. - Em projetos .NET Framework, o pacote
GroupDocs.Mergernão adiciona mais um redirecionamento de binding para System.ValueTuple emapp.configouweb.config(projetos packages.config), e seus alvos de compilação .NET Framework definemDependsOnNETStandardcomotruea menos que o projeto o defina.
Novos recursos
- Controle de recursos externos: Imagens remotas, folhas de estilo, imagens vinculadas e outros arquivos que um documento referencia não são mais carregados a menos que você os permita.
LoadOptionstem novas propriedadesSkipExternalResources,WhitelistedResourceseExternalResourceHandlerpara permitir locais confiáveis, permitir tudo para documentos em que confia, ou decidir, pular ou fornecer cada recurso em seu próprio código. - Correções de concorrência: Documentos EPUB não falham mais intermitentemente com
NullReferenceExceptionouIndexOutOfRangeException, e documentos TeX comArgumentException, quando são processados por várias threads. - Documentos EPUB: Documentos EPUB de layout fixo agora têm uma página por página do livro, de modo que a página N é a página N do livro. Documentos EPUB cujo arquivo de índice tem extensão diferente de
.ncxnão falham mais comNullReferenceException. - Saída PDF com auto‑tagging: Um documento PDF salvo com auto‑tagging mantém o formato e o título da origem. Não é mais marcado como PDF/UA-1 a menos que a origem fosse, e uma origem sem título não recebe mais o título “Tagged PDF”.
- Projetos .NET Framework: Junções de imagens em projetos packages.config não falham mais ao carregar System.ValueTuple, e junções com documentos SVG não falham mais ao carregar netstandard em tempos de execução .NET Framework 4.6.2 a 4.7.0.
- Dependência corrigida: Os pacotes dependem de System.Security.Cryptography.Pkcs 8.0.2 (.NET 6.0 e .NET 8.0) ou 9.0.21 (.NET 10.0), as versões que corrigem CVE-2026-84008 e CVE-2026-70162.
- Produtos LowCode: Um caminho de saída fornecido como um nome de arquivo simples é salvo no diretório atual, e
JoinPdf,JoinDocxeJoinPptxrejeitam um documento juntado de outro formato antes que qualquer saída seja escrita.
Exemplo 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
}
}
}
Como obter a atualização
NuGet
Atualize para o pacote GroupDocs.Merger mais recente via NuGet: GroupDocs.Merger 26.10.0
dotnet add package GroupDocs.Merger --version 26.10.0
Download direto
Baixe os assemblies na página GroupDocs.Merger for .NET 26.10.