Jsme rádi, že můžeme oznámit vydání GroupDocs.Conversion for .NET v26.10, dostupné od října 2026. Toto vydání se zaměřuje na kontrolu toho, co může dokument načíst: váš kód nyní může rozhodovat o každém externím zdroji, o který dokument požaduje, a výchozí nastavení jsou bezpečná pro dokumenty z neznámých zdrojů. Také zajišťuje, že konverze respektují požadovaný výstupní formát a výběr stránek, opravuje řadu selhání konverzí a problémů s načítáním v .NET Framework a aktualizuje citlivou bezpečnostní závislost — celkem 60 funkcí, vylepšení a oprav chyb.

Hlavní novinky

Rozhodněte, co může každý dokument načíst

Dokumenty často odkazují mimo sebe: obrázky na CDN, styly, skripty, 3D textury, XBRL taxonomie. Ve verzi 26.10 můžete vidět každou z těchto žádostí a rozhodnout o ní v kódu. Implementujte IExternalResourceHandler a nastavte jej pomocí vlastnosti ExternalResourceHandler v možnostech načítání. Handler přijímá každý zdroj s již předvyplněným výchozím rozhodnutím a může jej povolit, přeskočit nebo — pro většinu formátů — poskytnout samotný obsah, například z vlastní cache, takže se nic nevyžaduje.

Tento handler načítá JPEG obrázky z jednoho důvěryhodného hostitele nad rámec toho, co umožňují výchozí nastavení:

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());
}

Handler funguje s možnostmi načítání pro web, XML, zpracování textu, tabulky, CSV a TSV, prezentace, e‑mail, SVG, finance a 3D dokumenty.

Bezpečná výchozí nastavení pro nedůvěryhodné dokumenty

Převod souboru, který někdo nahrál, by neměl způsobit, že váš server bude číst jiné soubory nebo se spojovat s libovolnými hostiteli. S výchozími nastaveními ve verzi 26.10:

  • načítá lokální soubory pouze ze složky dokumentu a nikdy z UNC cest;
  • nespouští skripty v HTML, MHTML, XHTML a SVG dokumentech a nevyžaduje žádné skriptové soubory;
  • uplatňuje stejná pravidla na SVG, 3D modely, XBRL, XSL‑FO, Markdown a konverze e‑mail‑na‑tabulku.

Když vaše dokumenty legitimně potřebují externí zdroje, povolte je způsobem, který vyhovuje: uveďte důvěryhodná umístění v WhitelistedResources, rozhodněte o každém zdroji pomocí handleru nebo nastavte SkipExternalResources = false pro dokumenty, kterým důvěřujete. Skripty se spouštějí pouze tehdy, když nastavíte ExecuteScripts = true na WebLoadOptions nebo SvgLoadOptions. UNC cesty a odkazy javascript: nebo vbscript: se nikdy nenačtou, bez ohledu na nastavení.

Výstup, který jste požadovali

Některé konverze ignorovaly část požadavku. Několik z nich vždy zapisovalo DOCX, XLSX, PPTX nebo multi‑frame TIFF bez ohledu na zvolený cílový formát a výběr stránek byl ignorován u e‑mailu, webu a multi‑page TIFF na zpracování textu, u Word Flat OPC dokumentů a u Project na PS a PCL. Všechny nyní produkují to, co požadují konverzní možnosti. Vodoznaky se nyní také objevují při konverzi ne‑obrázkových dokumentů na obrázky a při konverzi CSV a TSV, MHT a MHTML stránky se vykreslují místo zobrazení jejich MIME zdroje a průhledná pozadí již nebudou černá v J2K, JP2, WMF a WMZ výstupech.

Méně selhání konverzí

PostScript soubory, které používají operátor run nebo file na .NET Framework, PSD, PSB a AI dokumenty stránku po stránce, celé CAD výkresy do TeX, XHTML s vloženým SVG, PDF, XPS a SVG do EPUB a Visio a SVG do tabulky nyní konvertují místo selhání. V e‑mailu, poštovní schránce a archivních souborech už příloha, kterou nelze převést do cílového formátu, nevede k selhání celé konverze a vložený dokument, který nelze načíst, je nyní hlášen přes ConversionEvents.OnDocumentFailed.

Bezpečnost, licence a .NET Framework

  • System.Security.Cryptography.Pkcs přechází na 8.0.2 (10.0.13 na .NET 10), řeší CVE‑2026‑84008 a CVE‑2026‑70162.
  • Projekty .NET Framework již nepropadnou při načítání RuntimeInformation nebo ValueTuple a konverze EML, HTML a CAD již nepropadnou na .NET Framework 4.6.2 až 4.7.0.
  • Konverze WebP s platnou licencí již neobsahují značku trial. V režimu hodnocení se limit 3 stránek nyní vztahuje i na SVG, SVGZ, PS a PCL výstupy.

Co je nového v tomto vydání

  • [Funkce] Přidání zpětného volání na úrovni zdroje pro kontrolu, povolení, odmítnutí nebo dodání každého externího zdroje, který dokument načítá
  • [Vylepšení] Nabídka SvgLoadOptions jako možnost načítání pro SVG a SVGZ dokumenty
  • [Vylepšení] Pojmenování OLM a NSF položek bez předmětu podle složky a pozice a vyhnutí se vyhrazeným názvům zařízení Windows v názvech poštovních položek
  • [Vylepšení] Hlásení archivních, e‑mailových a poštovních položek, které nelze načíst, do handleru pro selhání dokumentu místo pouhého logování
  • [Chyba] Značka trial se aplikuje při konverzi z WebP i když je použita platná licence
  • [Chyba] Specifická konverze VSDX — text mimo okraje rámečku
  • [Chyba] Dvojité přeškrtnutí textu není zachováno při konverzi ODT na PDF
  • [Chyba] Problémy s konverzí VCF na Excel
  • [Chyba] Oprava selhání konverzí při načítání RuntimeInformation ve starých .NET Framework 4.7.1+ projektech používajících PackageReference
  • [Chyba] Oprava selhání konverzí při načítání RuntimeInformation nebo ValueTuple v .NET Framework projektech s packages.config
  • [Chyba] Oprava selhání konverzí EML, HTML a CAD na .NET Framework 4.6.2 až 4.7.0 runtimech
  • [Chyba] Konverze WordProcessing, Pdf a ProjectManagement dokumentů do libovolného formátu tabulky vždy vytváří XLSX
  • [Chyba] Konverze WordProcessing, Pdf a Diagram dokumentů do libovolného formátu prezentace vždy vytváří PPTX
  • [Chyba] Oprava selhání konverze PST, OST a MBOX při položce bez předmětu a PST sticky notes konvertujících se na nečitelné texty
  • [Chyba] Konverze jednostránkového dokumentu na ne‑TIFF formát obrázku vždy vytváří multi‑frame TIFF
  • [Chyba] [GroupDocs.Conversion for .NET] Aktualizace System.Security.Cryptography.Pkcs na 8.0.2 (CVE‑2026‑84008 / CVE‑2026‑70162)
  • [Chyba] Textový nebo obrázkový vodoznak se nepoužije při konverzi ne‑obrázkových dokumentů na obrázky
  • [Chyba] Průhledné pozadí stránky se při konverzi na J2K, JP2, WMF a WMZ změní na černé
  • [Chyba] WMZ výstup Word‑založených dokumentů obsahuje gzipovaný PNG a EMZ výstup obrázků je gzipován dvakrát
  • [Chyba] MHT a MHTML stránky konvertované na obrázky zobrazují MIME zdroj místo stránky
  • [Chyba] Informace o dokumentu Publisher vždy uvádí jednu stránku
  • [Chyba] Vodoznak se nepoužije při konverzi CSV a TSV dokumentů
  • [Chyba] Načítání externích zdrojů pouze z přesně uvedených URL prefixů na whitelistu a ze složky dokumentu, nikdy z UNC cest
  • [Chyba] Oprava CAD, Image, Diagram, DjVu, VCF a Email na WordProcessing ukládajících DOCX pro každý cíl kromě DOC
  • [Chyba] Oprava Email na WordProcessing ignorující výběr stránek a rozsah stránek
  • [Chyba] Oprava multi‑page TIFF na WordProcessing ignorující výběr stránek
  • [Chyba] Respektování SkipExternalResources a WhitelistedResources při konverzi Markdown a CHM dokumentů
  • [Chyba] Respektování SkipExternalResources a WhitelistedResources v konverzích e‑mail‑na‑tabulku, tabulky a rozsahu stránek
  • [Chyba] Nepřidávat obrázky z mimo složku dokumentu jako výchozí při konverzi HTML na tabulku
  • [Chyba] Nepřidávat externí zdroje jako výchozí při konverzi SVG na prezentaci, zpracování textu, tabulku, XPS nebo EPS
  • [Chyba] Nepřidávat 3D knihovny materiálů, textury a buffery z mimo složku modelu jako výchozí
  • [Chyba] Nepřidávat externí obrázky jako výchozí při konverzi XML přes XSL‑FO stylopis
  • [Chyba] Oprava HTML a MHTML na WordProcessing ukládajících DOCX pro každý cíl
  • [Chyba] Nepřidávat XBRL a inline XBRL taxonomie z mimo složku dokumentu jako výchozí
  • [Chyba] Zastavit spouštění skriptů a stahování skriptových souborů při konverzi HTML, XHTML a SVG dokumentů
  • [Chyba] Oprava Web na WordProcessing ignorující výběr stránek a rozsah stránek
  • [Chyba] Oprava Word Flat OPC dokumentů ignorujících výběr stránek a rozsah stránek
  • [Chyba] Nepřidávat textury z mimo složku modelu jako výchozí při konverzi 3D dokumentů
  • [Chyba] Oprava archivů s jedním proudem komprese, které konvertují soubor bez názvu
  • [Chyba] Oprava načítání odkazů javascript: a vbscript: když jsou externí zdroje povoleny
  • [Chyba] Oprava XHTML dokumentů s vloženým SVG, které selhaly při konverzi
  • [Chyba] Oprava konverze HTML na HTML, která selhala, když nebylo možné načíst relativní CSS @import
  • [Chyba] Oprava konverze Visio a SVG na tabulku, která selhala na stránce bez obsahu k vykreslení
  • [Chyba] Oprava konverze PDF, XPS a SVG na EPUB, která selhala na hypertextovém odkazu bez textu
  • [Chyba] Oprava konverze e‑mailu, poštovní schránky a archivu, která selhala na příloze, kterou nelze převést do cílového formátu
  • [Chyba] Oprava konverze PCL, která nahrazovala Courier New a další nainstalované fonty po konverzi PDF
  • [Chyba] GroupDocs.Conversion.LowCode 26.9.0: DOCX na PDF na Linuxu ignoruje substituci fontů a používá první font v abecedním pořadí
  • [Chyba] Oprava chyb v XML dokumentaci v GroupDocs.Conversion.LowCode 26.9.0
  • [Chyba] Oprava selhání PostScript konverze na .NET Framework, když dokument používá operátor run nebo file
  • [Chyba] Oprava nelicencovaných konverzí do formátů popisu stránky, které ignorovaly limit trial stránky
  • [Chyba] Oprava konverze PSD, PSB a Illustrator AI dokumentů stránku po stránce, která selhala s výjimkou
  • [Chyba] Oprava konverze videa na audio formát, která selhala i když byl nastaven video konektor
  • [Chyba] Oprava konverze ProjectManagement na PS a PCL, která vytvářela nadbytečné stránky a ignorovala výběr stránek
  • [Chyba] Oprava ProjectManagement na SVG, která zapisovala UTF‑16 bez značky pořadí bajtů
  • [Chyba] Oprava 3D na glTF a OBJ, která zapisovala buffer a soubory materiálů do pracovního adresáře
  • [Chyba] Oprava konverzí MHT a MHTML na PDF, XPS, TeX a WordProcessing, které zobrazovaly MIME zdroj místo stránky
  • [Chyba] Oprava konverze CAD na TeX celého výkresu, která selhala s FileTypeNotSupported
  • [Chyba] Oprava konverzí PDL a XML/JSON na PS a PCL, které přidávaly nadbytečné stránky
  • [Chyba] Oprava konverzí CAD na PS a PCL, které zachovávaly jen jednu stránku multi‑page DWF výkresů
  • [Chyba] Oprava konverze MBOX, která selhala nebo ztrácela hlavičky e‑mailu, když předmět zprávy vypadal jako název souboru

Změny veřejného API

Nové API

  • IExternalResourceHandler a ExternalResourceLoadingArgs (Uri, Skipped, Data) v jmenném prostoru GroupDocs.Conversion.Options.Load.
  • ExternalResourceHandler na IResourceLoadingOptions a na možnostech načítání, které jej implementují.
  • ExecuteScripts na WebLoadOptions a SvgLoadOptions.
  • SkipExternalResources, WhitelistedResources a ExternalResourceHandler na FinanceLoadOptions a ThreeDLoadOptions, které nyní implementují IResourceLoadingOptions.

⚠️ Zkontrolujte před aktualizací

  • Externí zdroje: dokumenty, které se spoléhaly na lokální soubory mimo svou složku, UNC cesty nebo skripty, se nyní konvertují bez nich. Povolit to, co důvěřujete, jak je popsáno v Bezpečná výchozí nastavení pro nedůvěryhodné dokumenty.

  • Položky whitelistu: každá položka WhitelistedResources musí být absolutní URI prefix, například https://cdn.example.com/assets/ nebo file:///C:/assets/. Položky jako jpg nebo example.com, které starší verze odpovídaly kdekoliv v URL, nyní způsobí selhání načítání s InvalidLoadOptionsException.

  • XBRL a inline XBRL: podání, jehož taxonomie leží mimo jeho složku, nebo načtené ze streamu, nyní selže s InvalidLoadOptionsException. Načtěte podání, kterému důvěřujete, takto:

    using (Converter converter = new Converter("filing.xbrl", (LoadContext loadContext) => new FinanceLoadOptions { SkipExternalResources = false }))
{
    converter.Convert("filing.xlsx", new SpreadsheetConvertOptions());
}

  • SVG a SVGZ: konvertovány bez možností načítání nyní používají SvgLoadOptions a PossibleConversions.LoadOptions vrací SvgLoadOptions místo PageDescriptionLanguageLoadOptions.

  • Výstupní formát a stránky: konverze nyní respektují požadovaný formát a výběr stránek, takže výstup se může lišit od starších verzí při stejných možnostech. PublisherDocumentInfo.PagesCount nyní vrací skutečný počet stránek.

  • Vlastní implementace IResourceLoadingOptions musí přidat novou vlastnost ExternalResourceHandler.

Poznámky k vydání (release notes) uvádějí každou změnu s přesnými zprávami výjimek.

Jak získat aktualizaci

NuGet

Aktualizujte na nejnovější balíček GroupDocs.Conversion přes NuGet: GroupDocs.Conversion 26.10.0

dotnet add package GroupDocs.Conversion --version 26.10.0

Přímé stažení

Stáhněte sestavení ze stránky GroupDocs.Conversion for .NET 26.10

Zdroje