Estamos felizes em anunciar o lançamento do GroupDocs.Conversion for .NET v26.10, disponível a partir de Outubro de 2026. Esta versão trata do controle sobre o que um documento tem permissão para carregar: seu código agora pode decidir sobre cada recurso externo que um documento solicita, e as configurações padrão são seguras para documentos de fontes desconhecidas. Ela também faz com que as conversões respeitem o formato de saída solicitado e a seleção de páginas, corrige uma série de falhas de conversão e problemas de carregamento no .NET Framework, e atualiza uma dependência sensível à segurança — 60 recursos, melhorias e correções de bugs no total.
Destaques
Decida o que cada documento pode carregar
Documentos frequentemente apontam para recursos externos: imagens em um CDN, folhas de estilo, scripts, texturas 3D, taxonomias XBRL. Na 26.10 você pode ver cada uma dessas solicitações e decidir sobre elas no código. Implemente IExternalResourceHandler e defina-o através da propriedade ExternalResourceHandler das opções de carregamento. O manipulador recebe cada recurso com a decisão padrão já preenchida, e pode permiti‑lo, ignorá‑lo ou — para a maioria dos formatos — fornecer o conteúdo próprio, por exemplo a partir do seu cache, de modo que nada seja solicitado.
Este manipulador carrega imagens JPEG de um host confiável além do que os padrões permitem:
public class TrustedJpegHandler : IExternalResourceHandler
{
public void OnLoading(ExternalResourceLoadingArgs args)
{
Uri uri;
if (Uri.TryCreate(args.Uri, UriKind.Absolute, out uri)
&& uri.Scheme == Uri.UriSchemeHttps
&& string.Equals(uri.Host, "cdn.example.com", StringComparison.OrdinalIgnoreCase)
&& (uri.AbsolutePath.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase)
|| uri.AbsolutePath.EndsWith(".jpeg", StringComparison.OrdinalIgnoreCase)))
{
args.Skipped = false;
}
}
}
WebLoadOptions loadOptions = new WebLoadOptions
{
ExternalResourceHandler = new TrustedJpegHandler()
};
using (Converter converter = new Converter("sample.html", (LoadContext loadContext) => loadOptions))
{
converter.Convert("converted.pdf", new PdfConvertOptions());
}
O manipulador funciona com as opções de carregamento para web, XML, processamento de texto, planilha, CSV e TSV, apresentação, e‑mail, SVG, finanças e documentos 3D.
Configurações padrão seguras para documentos não confiáveis
Converter um arquivo enviado por alguém não deve fazer seu servidor ler outros arquivos ou acessar hosts arbitrários. Com as configurações padrão, a 26.10:
- carrega arquivos locais apenas da própria pasta do documento, e nunca de caminhos UNC;
- não executa scripts em documentos HTML, MHTML, XHTML e SVG, e não solicita arquivos de script;
- aplica as mesmas regras a SVG, modelos 3D, XBRL, XSL‑FO, Markdown e conversões de e‑mail para planilha.
Quando seus documentos realmente precisam de recursos externos, permita‑os da forma que melhor se encaixe: liste locais confiáveis em WhitelistedResources, decida por recurso com o manipulador, ou defina SkipExternalResources = false para documentos em que confia. Scripts são executados apenas quando você define ExecuteScripts = true em WebLoadOptions ou SvgLoadOptions. Caminhos UNC e referências javascript: ou vbscript: nunca são carregados, independentemente das configurações.
A saída que você solicitou
Algumas conversões ignoravam parte da solicitação. Várias sempre geravam DOCX, XLSX, PPTX ou um TIFF multi‑frame independentemente do formato de destino escolhido, e a seleção de páginas era ignorada para e‑mail, web e TIFF multi‑página para processamento de texto, para documentos Word Flat OPC, e para Project para PS e PCL. Todas agora produzem o que as opções de conversão pedem. Marcas d’água agora também aparecem ao converter documentos não‑imagem para imagens e ao converter CSV e TSV, páginas MHT e MHTML são renderizadas em vez de mostrar sua fonte MIME, e fundos transparentes não ficam mais pretos em saídas J2K, JP2, WMF e WMZ.
Menos conversões com falha
Arquivos PostScript que usam o operador run ou file no .NET Framework, documentos PSD, PSB e AI página por página, desenhos CAD completos para TeX, XHTML com SVG embutido, PDF, XPS e SVG para EPUB, e Visio e SVG para planilha agora convertem em vez de falhar. Em arquivos de e‑mail, caixa de correio e arquivo, um anexo que não pode ser convertido para o formato de destino não falha mais a conversão inteira, e um documento contido que não pode ser carregado agora é relatado através de ConversionEvents.OnDocumentFailed.
Segurança, licenciamento e .NET Framework
- System.Security.Cryptography.Pkcs avança para 8.0.2 (10.0.13 no .NET 10), abordando CVE-2026-84008 e CVE-2026-70162.
- Projetos .NET Framework não falham mais ao carregar RuntimeInformation ou ValueTuple, e conversões EML, HTML e CAD não falham mais no .NET Framework 4.6.2 a 4.7.0.
- Conversões WebP com licença válida não exibem mais a marca de avaliação. No modo de avaliação, o limite de 3 páginas agora também se aplica a saídas SVG, SVGZ, PS e PCL.
O que há de novo nesta versão
- [Feature] Adicionar um callback por recurso para inspecionar, permitir, negar ou fornecer cada recurso externo que um documento carrega
- [Improvement] Oferecer SvgLoadOptions como opções de carregamento para documentos SVG e SVGZ
- [Improvement] Nomear itens OLM e NSF sem assunto pelo nome da pasta e posição e evitar nomes de dispositivos reservados do Windows em nomes de itens de caixa de correio
- [Improvement] Relatar itens de arquivo, e‑mail e caixa de correio que não podem ser carregados ao manipulador de falha de documento em vez de apenas registrá‑los
- [Bug] Marca de avaliação é aplicada ao converter de Webp mesmo quando uma licença válida está aplicada
- [Bug] Conversão específica de arquivo VSDX – texto fora dos limites da caixa
- [Bug] Texto com tachado duplo não preservado na conversão ODT para PDF
- [Bug] Problemas na conversão de VCF para Excel
- [Bug] Corrigir conversões que falham ao carregar RuntimeInformation em projetos .NET Framework 4.7.1+ estilo antigo que usam PackageReference
- [Bug] Corrigir conversões que falham ao carregar RuntimeInformation ou ValueTuple em projetos .NET Framework packages.config
- [Bug] Corrigir conversões EML, HTML e CAD que falham em runtimes .NET Framework 4.6.2 a 4.7.0
- [Bug] Converter documentos WordProcessing, Pdf e ProjectManagement para qualquer formato de planilha sempre produz XLSX
- [Bug] Converter documentos WordProcessing, Pdf e Diagram para qualquer formato de apresentação sempre produz PPTX
- [Bug] Corrigir falha de conversão PST, OST e MBOX em item sem assunto e notas adesivas PST convertendo para texto ilegível
- [Bug] Converter um documento de página única para formato de imagem não‑TIFF sempre produz um TIFF multi‑frame
- [Bug] [GroupDocs.Conversion for .NET] Atualizar System.Security.Cryptography.Pkcs para 8.0.2 (CVE-2026-84008 / CVE-2026-70162)
- [Bug] Marca d’água de texto ou imagem não é aplicada ao converter documentos não‑imagem para imagens
- [Bug] Fundo de página transparente fica preto ao converter para J2K, JP2, WMF e WMZ
- [Bug] Saída WMZ de documentos baseados em Word contém um PNG compactado em gzip e saída EMZ de imagens é compactada duas vezes
- [Bug] Páginas MHT e MHTML convertidas para imagens mostram a fonte MIME em vez da página
- [Bug] Informações de documento de um documento Publisher sempre relatam uma página
- [Bug] Marca d’água não é aplicada ao converter documentos CSV e TSV
- [Bug] Carregar recursos externos apenas de prefixos de URL exatamente na lista branca e da própria pasta do documento, nunca de caminhos UNC
- [Bug] Corrigir CAD, Image, Diagram, DjVu, VCF e Email para WordProcessing salvando DOCX para todo alvo exceto DOC
- [Bug] Corrigir Email para WordProcessing ignorando seleção de página e intervalo de páginas
- [Bug] Corrigir TIFF multi‑página para WordProcessing ignorando seleção de página
- [Bug] Respeitar SkipExternalResources e WhitelistedResources ao converter documentos Markdown e CHM
- [Bug] Respeitar SkipExternalResources e WhitelistedResources em conversões e‑mail‑para‑planilha, planilha e intervalo de páginas
- [Bug] Não carregar imagens de fora da pasta do documento por padrão ao converter HTML para planilha
- [Bug] Não carregar recursos externos por padrão ao converter SVG para apresentação, processamento de texto, planilha, XPS ou EPS
- [Bug] Não carregar bibliotecas de materiais 3D, texturas e buffers de fora da pasta do modelo por padrão
- [Bug] Não carregar imagens externas por padrão ao converter XML através de uma folha de estilo XSL‑FO
- [Bug] Corrigir HTML e MHTML para WordProcessing salvando DOCX para todo alvo
- [Bug] Não carregar taxonomias XBRL e XBRL embutidas de fora da pasta do documento por padrão
- [Bug] Parar de executar scripts e baixar arquivos de script ao converter documentos HTML, XHTML e SVG
- [Bug] Corrigir Web para WordProcessing ignorando seleção de página e intervalo de páginas
- [Bug] Corrigir documentos Word Flat OPC ignorando seleção de página e intervalo de páginas
- [Bug] Não incorporar texturas de fora da pasta do modelo por padrão ao converter documentos 3D
- [Bug] Corrigir arquivos de compressão de fluxo único que convertem seu arquivo sem nome
- [Bug] Corrigir referências javascript: e vbscript: sendo buscadas quando recursos externos são permitidos
- [Bug] Corrigir documentos XHTML com SVG embutido que falham ao converter
- [Bug] Corrigir conversão HTML para HTML que falha quando um CSS @import relativo não pode ser carregado
- [Bug] Corrigir conversão Visio e SVG para planilha que falha em página sem conteúdo a desenhar
- [Bug] Corrigir conversão PDF, XPS e SVG para EPUB que falha em hiperlink que não cobre texto
- [Bug] Corrigir conversão de e‑mail, caixa de correio e arquivo que falha em anexo que não pode ser convertido para o formato de destino
- [Bug] Corrigir conversão PCL que substitui Courier New e outras fontes instaladas após conversão de PDF
- [Bug] GroupDocs.Conversion.LowCode 26.9.0: DOCX para PDF no Linux ignora substituição de fontes e usa a primeira fonte em ordem alfabética
- [Bug] Corrigir erros de documentação XML em GroupDocs.Conversion.LowCode 26.9.0
- [Bug] Corrigir conversão PostScript que falha no .NET Framework quando um documento usa o operador run ou file
- [Bug] Corrigir conversões não licenciadas para formatos de linguagem de descrição de página ignorando o limite de página de avaliação
- [Bug] Corrigir conversão página a página de documentos PSD, PSB e Illustrator AI que falha com exceção
- [Bug] Corrigir conversão de vídeo para formato de áudio que falha mesmo quando um conector de vídeo está definido
- [Bug] Corrigir conversão ProjectManagement para PS e PCL que produz páginas extras e ignora seleção de página
- [Bug] Corrigir ProjectManagement para SVG que grava UTF‑16 sem marca de ordem de bytes
- [Bug] Corrigir 3D para glTF e OBJ que grava arquivos de buffer e material no diretório de trabalho
- [Bug] Corrigir conversões MHT e MHTML para PDF, XPS, TeX e WordProcessing que mostram a fonte MIME em vez da página
- [Bug] Corrigir conversão CAD para TeX de um desenho completo que falha com FileTypeNotSupported
- [Bug] Corrigir conversões PDL e XML/JSON para PS e PCL que adicionam páginas extras
- [Bug] Corrigir conversões CAD para PS e PCL que mantêm apenas uma página de desenhos DWF multi‑page
- [Bug] Corrigir conversão MBOX que falha ou descarta os cabeçalhos de e‑mail quando o assunto da mensagem parece um nome de arquivo
Alterações na API pública
Nova API
IExternalResourceHandlereExternalResourceLoadingArgs(Uri,Skipped,Data) no namespaceGroupDocs.Conversion.Options.Load.ExternalResourceHandleremIResourceLoadingOptionse nas opções de carregamento que o implementam.ExecuteScriptsemWebLoadOptionseSvgLoadOptions.SkipExternalResources,WhitelistedResourceseExternalResourceHandleremFinanceLoadOptionseThreeDLoadOptions, que agora implementamIResourceLoadingOptions.
⚠️ Verifique antes de atualizar
-
Recursos externos: documentos que dependiam de arquivos locais fora de sua pasta, caminhos UNC ou scripts agora convertem sem eles. Permita o que confia conforme descrito em Configurações padrão seguras para documentos não confiáveis.
-
Entradas da lista branca: cada entrada em
WhitelistedResourcesdeve ser um prefixo de URI absoluto, comohttps://cdn.example.com/assets/oufile:///C:/assets/. Entradas comojpgouexample.com, que nas versões anteriores combinavam em qualquer parte da URL, agora fazem o carregamento falhar comInvalidLoadOptionsException. -
XBRL e XBRL embutido: um filing cuja taxonomia está fora de sua pasta, ou que foi carregado a partir de um stream, agora falha ao carregar com
InvalidLoadOptionsException. Carregue filings confiáveis assim:using (Converter converter = new Converter("filing.xbrl", (LoadContext loadContext) => new FinanceLoadOptions { SkipExternalResources = false })) { converter.Convert("filing.xlsx", new SpreadsheetConvertOptions()); } -
SVG e SVGZ: convertidos sem opções de carregamento, agora utilizam
SvgLoadOptions, ePossibleConversions.LoadOptionsretornaSvgLoadOptionsem vez dePageDescriptionLanguageLoadOptions. -
Formato de saída e páginas: as conversões agora honram o formato solicitado e a seleção de páginas, de modo que a saída pode diferir das versões anteriores para as mesmas opções.
PublisherDocumentInfo.PagesCountagora devolve a contagem real de páginas. -
Implementações personalizadas de
IResourceLoadingOptionsdevem adicionar a nova propriedadeExternalResourceHandler.
As notas de lançamento listam cada mudança com as mensagens de exceção exatas.
Como obter a atualização
NuGet
Atualize para o pacote mais recente GroupDocs.Conversion via NuGet: GroupDocs.Conversion 26.10.0
dotnet add package GroupDocs.Conversion --version 26.10.0
Download direto
Baixe os assemblies na página GroupDocs.Conversion for .NET 26.10
Recursos
- Notas de Lançamento Completo
- Documentação
- Acesso à rede e privacidade de dados – quando a biblioteca acessa a rede e como executá‑la offline
- Ignorar carregamento de recursos externos – padrões, entradas da lista branca, manipulador por recurso e scripts
- Notas de migração – migrando para 26.10
- Opções de carregamento para diferentes tipos de documento
- Exemplos no GitHub – locais confiáveis, manipulador por recurso, scripts de HTML confiável e XBRL com taxonomia remota
- Free Support Forum