Siamo felici di annunciare il rilascio di GroupDocs.Conversion for .NET v26.9, disponibile a partire da settembre 2026. Questa versione introduce il supporto per nuovi formati GIS e di compressione, consente la conversione delle presentazioni in slideshow HTML autonomi, migliora la gestione dei TIFF multi‑pagina e impone un limite di valutazione di 10 conversioni per processo. Rimuove inoltre membri API obsoleti e applica una convalida più rigorosa per le opzioni in conflitto.

Novità di questa versione

  • [Funzionalità] Aggiungi WIM come sorgente di conversione per documenti di compressione (CONVERSIONNET-8488)
  • [Funzionalità] Aggiungi Apple Archive (AAR) come sorgente e destinazione di conversione per documenti di compressione (CONVERSIONNET-8491)
  • [Funzionalità] Aggiungi ALZ come sorgente di conversione per documenti di compressione (CONVERSIONNET-8494)
  • [Funzionalità] Aggiungi GeoJSON Text Sequence come sorgente di conversione per documenti GIS (CONVERSIONNET-8508)
  • [Funzionalità] Aggiungi KMZ come sorgente di conversione per documenti GIS (CONVERSIONNET-8510)
  • [Funzionalità] Aggiungi il supporto alla conversione GIS per il framework di destinazione net462 (CONVERSIONNET-8511)
  • [Funzionalità] Aggiungi GML e OSM XML come destinazioni di conversione per documenti GIS (CONVERSIONNET-8512)
  • [Funzionalità] Converti una presentazione in uno slideshow HTML autonomo (CONVERSIONNET-8529)
  • [Miglioramento] Applica la dimensione e la risoluzione della pagina di ciascun fotogramma quando si converte un TIFF multi‑pagina in PDF (CONVERSIONNET-8519)
  • [Miglioramento] Applica la dimensione e la risoluzione del fotogramma quando si converte un TIFF multi‑pagina pagina per pagina (CONVERSIONNET-8520)
  • [Miglioramento] Applica la dimensione e la risoluzione di ciascun fotogramma quando si converte un TIFF multi‑pagina in PDF con tag (CONVERSIONNET-8521)
  • [Miglioramento] Limita la modalità di valutazione a 10 conversioni per processo (CONVERSIONNET-8523)
  • [Miglioramento] Rimuovi il listener del convertitore obsoleto, le fasi del gestore fluente e le proprietà di dimensione della pagina (CONVERSIONNET-8561)
  • [Bug] PPTX → PDF: doppia sottolineatura e doppio barrato generano coordinate NaN su Linux (CONVERSIONNET-8388)
  • [Bug] La conversione di un PDF con più di 4 pagine fallisce in modalità valutazione (CONVERSIONNET-8515)
  • [Bug] Il limite di pagine di prova non viene applicato quando si converte PDF in Web (CONVERSIONNET-8516)
  • [Bug] Restituisce il conteggio corretto delle pagine per un TIFF multi‑pagina (CONVERSIONNET-8522)

Modifiche all’API pubblica

Modifiche breaking

I membri contrassegnati come obsoleti nelle versioni precedenti sono stati rimossi:

Rimosso Sostituzione
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 = ...)
Interfacce fluide IConversionHandlerSetup, IConversionHandlerFailed, IConversionHandlerCompleted IConversionHandlersStage
Interfacce fluide IConversionByPageHandlerSetup, IConversionByPageHandlerFailed, IConversionByPageHandlerCompleted IConversionByPageHandlersStage
CadConvertOptions.PageSize / PageWidth / PageHeight CadConvertOptions.SizeSettings (PageSizeOptions)
EBookConvertOptions.PageSize / PageWidth / PageHeight EBookConvertOptions.SizeSettings (PageSizeOptions)

Nell’API fluente, WithOptions(...) ora restituisce IConversionHandlersStage (o IConversionByPageHandlersStage per la conversione pagina per pagina). Chiamate concatenate come .WithOptions(...).OnConversionCompleted(...).OnConversionFailed(...).Convert() compilano senza modifiche.

La dimensione della pagina ora si imposta esclusivamente tramite SizeSettings:

var options = new CadConvertOptions
{
    SizeSettings = new PageSizeOptions { PageWidth = 800, PageHeight = 600 }
};

Limite di conversione in modalità valutazione

Senza una licenza valida, un processo può eseguire al massimo 10 conversioni. Ogni chiamata a Converter.Convert(...) conta come una conversione — qualsiasi overload, l’API fluente e le chiamate che falliscono — indipendentemente dal numero di file di output prodotti. Converter.GetDocumentInfo() e Converter.IsDocumentPasswordProtected() non contano. Il conteggio è legato al processo in esecuzione; riavviando l’applicazione il conteggio ricomincia da zero. Una volta applicata una licenza valida, le conversioni non sono più contate né limitate.

La 11ª conversione genera una EvaluationLimitReachedException (derivata da GroupDocsConversionException) con il messaggio:

Stai usando GroupDocs.Conversion in modalità valutazione: è stato raggiunto il limite di 10 documenti convertiti per processo. Ottieni una licenza temporanea gratuita di 30 giorni per rimuovere tutti i limiti di valutazione: https://purchase.groupdocs.com/temporary-license/

Applica una License o una chiave Metered prima della prima conversione per rimuovere il limite:

License license = new License();
license.SetLicense("GroupDocs.Conversion.lic");

using (Converter converter = new Converter("sample.docx"))
{
    converter.Convert("converted.pdf", new PdfConvertOptions());
}

Il codice che viene eseguito senza licenza può gestire il limite:

try
{
    using (Converter converter = new Converter("sample.docx"))
    {
        converter.Convert("converted.pdf", new PdfConvertOptions());
    }
}
catch (EvaluationLimitReachedException ex)
{
    Console.WriteLine(ex.Message);
}

Output slideshow per conversione da presentazione a HTML

La nuova proprietà WebConvertOptions.SlideShow (predefinita false) converte una presentazione — PPT, PPTX, PPTM, PPS, PPSX, PPSM, POT, POTX, POTM, ODP, OTP o FODP — in un unico file HTML autonomo (Html o Htm) che viene riprodotto come slideshow. Le conversioni esistenti rimangono invariate a meno che SlideShow non sia impostato a true.

using (Converter converter = new Converter("presentation.pptx"))
{
    WebConvertOptions options = new WebConvertOptions { SlideShow = true };
    converter.Convert("slideshow.html", options);
}

Con SlideShow = true, le opzioni contraddittorie generano una InvalidConvertOptionsException prima dell’inizio della conversione:

Opzione Messaggio
UsePdf = true WebConvertOptions.SlideShow cannot be combined with UsePdf: converting through PDF discards the slideshow.
Format è MHT o MHTML WebConvertOptions.SlideShow supports only Html and Htm output, not mht. (o mhtml)
Watermark è impostato WebConvertOptions.SlideShow does not support watermarks.
Zoom diverso da 100 WebConvertOptions.SlideShow does not support Zoom.

Uno slideshow è un unico documento navigabile, quindi gli overload di Convert pagina per pagina generano System.NotSupportedException con il messaggio Saving a presentation slideshow page by page is not supported.

Nuovi tipi di file

Tipo Nuovi membri
CompressionFileType Aar, Alz, Wim
GisFileType GeoJsonSeq, Kmz
Informazioni documento AarDocumentInfo, AlzDocumentInfo, WimDocumentInfo — ciascuno espone l’ContentTree dell’archivio

Esempio di conversione di un ZIP in Apple Archive:

using (Converter converter = new Converter("assets.zip"))
{
    CompressionConvertOptions options = new CompressionConvertOptions { Format = CompressionFileType.Aar };
    converter.Convert("assets.aar", options);
}

Come ottenere l’aggiornamento

NuGet

Aggiorna al pacchetto più recente GroupDocs.Conversion tramite NuGet: GroupDocs.Conversion 26.9.0

dotnet add package GroupDocs.Conversion --version 26.9.0

Download diretto

Scarica gli assembly dalla pagina GroupDocs.Conversion for .NET 26.9

Risorse