Estamos felizes em anunciar o lançamento do GroupDocs.Conversion for .NET v26.9, disponível a partir de setembro de 2026. Esta versão introduz suporte a novos formatos GIS e de compressão, permite a conversão de apresentações para apresentações HTML autônomas, melhora o tratamento de TIFFs de múltiplas páginas e impõe um limite de 10 conversões em modo de avaliação por processo. Também remove membros de API obsoletos e aplica validações mais rigorosas para opções conflitantes.
O que há de novo nesta versão
- [Recurso] Adicionar WIM como fonte de conversão para documentos de compressão (CONVERSIONNET-8488)
- [Recurso] Adicionar Apple Archive (AAR) como fonte e destino de conversão para documentos de compressão (CONVERSIONNET-8491)
- [Recurso] Adicionar ALZ como fonte de conversão para documentos de compressão (CONVERSIONNET-8494)
- [Recurso] Adicionar GeoJSON Text Sequence como fonte de conversão para documentos GIS (CONVERSIONNET-8508)
- [Recurso] Adicionar KMZ como fonte de conversão para documentos GIS (CONVERSIONNET-8510)
- [Recurso] Adicionar suporte à conversão GIS ao framework de destino net462 (CONVERSIONNET-8511)
- [Recurso] Adicionar GML e OSM XML como destinos de conversão para documentos GIS (CONVERSIONNET-8512)
- [Recurso] Converter uma apresentação para uma apresentação HTML autônoma (CONVERSIONNET-8529)
- [Melhoria] Aplicar o tamanho de página e a resolução próprios de cada quadro ao converter TIFF de múltiplas páginas para PDF (CONVERSIONNET-8519)
- [Melhoria] Aplicar o tamanho de página e a resolução próprios do quadro ao converter um TIFF de múltiplas páginas página a página (CONVERSIONNET-8520)
- [Melhoria] Aplicar o tamanho de página e a resolução próprios de cada quadro ao converter um TIFF de múltiplas páginas para PDF marcado (CONVERSIONNET-8521)
- [Melhoria] Limitar o modo de avaliação a 10 conversões por processo (CONVERSIONNET-8523)
- [Melhoria] Remover o ouvinte de conversor obsoleto, estágios de manipulador fluente e propriedades de tamanho de página (CONVERSIONNET-8561)
- [Bug] PPTX para PDF: sublinhado duplo e tachado duplo geram coordenadas NaN no Linux (CONVERSIONNET-8388)
- [Bug] Converter um PDF com mais de 4 páginas falha no modo de avaliação (CONVERSIONNET-8515)
- [Bug] O limite de páginas de avaliação não é aplicado ao converter PDF para Web (CONVERSIONNET-8516)
- [Bug] Retornar a contagem correta de páginas para um TIFF de múltiplas páginas (CONVERSIONNET-8522)
Alterações na API pública
Alterações que quebram compatibilidade
Os membros que foram marcados como obsoletos em versões anteriores foram removidos:
| Removido | Substituição |
|---|---|
IConverterListener e ConverterSettings.Listener |
ConversionEvents OnConversionStarted / OnConversionProgress / OnConversionCompleted |
ConverterSettings.OnConversionFailed |
ConversionEvents.OnDocumentFailed |
ConverterSettings.OnConversionByPageFailed |
ConversionEvents.OnPageFailed |
ConverterSettings.OnCompressionCompleted |
ConversionEvents.OnCompressionCompleted |
Fluent .OnCompressionCompleted(...) after .Compress(...) (IConversionCompressResultCompleted) |
FluentConverter.WithEvents(e => e.OnCompressionCompleted = ...) |
Interfaces fluentes IConversionHandlerSetup, IConversionHandlerFailed, IConversionHandlerCompleted |
IConversionHandlersStage |
Interfaces fluentes IConversionByPageHandlerSetup, IConversionByPageHandlerFailed, IConversionByPageHandlerCompleted |
IConversionByPageHandlersStage |
CadConvertOptions.PageSize / PageWidth / PageHeight |
CadConvertOptions.SizeSettings (PageSizeOptions) |
EBookConvertOptions.PageSize / PageWidth / PageHeight |
EBookConvertOptions.SizeSettings (PageSizeOptions) |
Na API fluente, WithOptions(...) agora devolve IConversionHandlersStage (ou IConversionByPageHandlersStage para conversão página a página). Chamadas encadeadas como .WithOptions(...).OnConversionCompleted(...).OnConversionFailed(...).Convert() continuam compilando sem alterações.
O tamanho de página agora é definido apenas através de SizeSettings:
var options = new CadConvertOptions
{
SizeSettings = new PageSizeOptions { PageWidth = 800, PageHeight = 600 }
};
Limite de conversão no modo de avaliação
Sem uma licença válida, um processo pode executar no máximo 10 conversões. Cada chamada a Converter.Convert(...) conta como uma conversão — qualquer sobrecarga, a API fluente e chamadas que falham — independentemente de quantos arquivos de saída sejam gerados. Converter.GetDocumentInfo() e Converter.IsDocumentPasswordProtected() não contam. A contagem pertence ao processo em execução; reiniciar a aplicação reinicia a contagem. Quando uma licença válida é aplicada, as conversões deixam de ser contadas ou limitadas.
A 11ª conversão lança EvaluationLimitReachedException (derivada de GroupDocsConversionException) com a mensagem:
Você está usando o GroupDocs.Conversion no modo de avaliação: o limite de 10 documentos convertidos por processo foi atingido. Obtenha uma licença temporária gratuita de 30 dias para remover todos os limites de avaliação: https://purchase.groupdocs.com/temporary-license/
Aplique uma chave License ou Metered antes da primeira conversão para remover o limite:
License license = new License();
license.SetLicense("GroupDocs.Conversion.lic");
using (Converter converter = new Converter("sample.docx"))
{
converter.Convert("converted.pdf", new PdfConvertOptions());
}
Código que roda sem licença pode tratar o limite:
try
{
using (Converter converter = new Converter("sample.docx"))
{
converter.Convert("converted.pdf", new PdfConvertOptions());
}
}
catch (EvaluationLimitReachedException ex)
{
Console.WriteLine(ex.Message);
}
Saída de apresentação de slides para conversão de apresentação‑para‑HTML
A nova propriedade WebConvertOptions.SlideShow (padrão false) converte uma apresentação — PPT, PPTX, PPTM, PPS, PPSX, PPSM, POT, POTX, POTM, ODP, OTP ou FODP — para um único arquivo HTML autônomo (Html ou Htm) que é reproduzido como apresentação de slides. Conversões existentes permanecem inalteradas a menos que SlideShow seja definido como true.
using (Converter converter = new Converter("presentation.pptx"))
{
WebConvertOptions options = new WebConvertOptions { SlideShow = true };
converter.Convert("slideshow.html", options);
}
Com SlideShow = true, opções contraditórias lançam InvalidConvertOptionsException antes do início da conversão:
| Opção | Mensagem |
|---|---|
UsePdf = true |
WebConvertOptions.SlideShow cannot be combined with UsePdf: converting through PDF discards the slideshow. |
Format é MHT ou MHTML |
WebConvertOptions.SlideShow supports only Html and Htm output, not mht. (ou mhtml) |
Watermark está definido |
WebConvertOptions.SlideShow does not support watermarks. |
Zoom diferente de 100 |
WebConvertOptions.SlideShow does not support Zoom. |
Uma apresentação de slides é um documento navegável único, portanto as sobrecargas de Convert página a página lançam System.NotSupportedException com a mensagem Saving a presentation slideshow page by page is not supported.
Novos tipos de arquivo
| Tipo | Novos membros |
|---|---|
CompressionFileType |
Aar, Alz, Wim |
GisFileType |
GeoJsonSeq, Kmz |
| Informações de documento | AarDocumentInfo, AlzDocumentInfo, WimDocumentInfo — cada um expõe a ContentTree do arquivo compactado |
Exemplo de conversão de um ZIP para Apple Archive:
using (Converter converter = new Converter("assets.zip"))
{
CompressionConvertOptions options = new CompressionConvertOptions { Format = CompressionFileType.Aar };
converter.Convert("assets.aar", options);
}
Como obter a atualização
NuGet
Atualize para o pacote mais recente GroupDocs.Conversion via NuGet: GroupDocs.Conversion 26.9.0
dotnet add package GroupDocs.Conversion --version 26.9.0
Download direto
Faça o download dos assemblies na página GroupDocs.Conversion for .NET 26.9