Wij zijn blij de release van GroupDocs.Conversion for .NET v26.10 aan te kondigen, beschikbaar vanaf oktober 2026. Deze release draait om controle over wat een document mag laden: uw code kan nu over elke externe bron die een document opvraagt beslissen, en de standaardinstellingen zijn veilig voor documenten van onbekende bronnen. Het zorgt er ook voor dat conversies het gevraagde uitvoerformaat en paginaselectie respecteren, lost een reeks conversiefouten en .NET Framework‑laadproblemen op, en werkt een beveiligingsgevoelige afhankelijkheid bij — in totaal 60 functies, verbeteringen en bugfixes.
Hoogtepunten
Beslis wat elk document mag laden
Documenten verwijzen vaak naar externe bronnen: afbeeldingen op een CDN, stylesheets, scripts, 3D‑texturen, XBRL‑taxonomieën. In 26.10 kunt u elk van deze verzoeken zien en er in code over beslissen. Implementeer IExternalResourceHandler en stel deze in via de ExternalResourceHandler‑eigenschap van de laadopties. De handler ontvangt elke bron met de standaardbeslissing al ingevuld, en kan deze toestaan, overslaan of — voor de meeste formaten — de inhoud zelf leveren, bijvoorbeeld uit uw eigen cache, zodat er helemaal niets wordt opgevraagd.
Deze handler laadt JPEG‑afbeeldingen van één vertrouwde host bovenop wat de standaardinstellingen toestaan:
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());
}
De handler werkt met de laadopties voor web, XML, tekstverwerking, spreadsheet, CSV en TSV, presentatie, e‑mail, SVG, financiën en 3D‑documenten.
Veilige standaardinstellingen voor onbetrouwbare documenten
Het converteren van een bestand dat iemand heeft geüpload mag uw server niet laten andere bestanden lezen of contact opnemen met willekeurige hosts. Met de standaardinstellingen, 26.10:
- laadt lokale bestanden alleen vanuit de eigen map van het document, en nooit vanaf UNC‑paden;
- voert geen scripts uit in HTML-, MHTML-, XHTML- en SVG‑documenten, en vraagt geen scriptbestanden aan;
- past dezelfde regels toe op SVG-, 3D‑modellen, XBRL-, XSL‑FO-, Markdown- en e‑mail‑naar‑spreadsheet‑conversies.
Wanneer uw documenten legitiem externe bronnen nodig hebben, sta ze toe op de manier die past: lijst vertrouwde locaties op in WhitelistedResources, beslis per bron met de handler, of stel SkipExternalResources = false in voor documenten die u vertrouwt. Scripts worden alleen uitgevoerd wanneer u ExecuteScripts = true instelt op WebLoadOptions of SvgLoadOptions. UNC‑paden en javascript:‑ of vbscript:‑referenties worden nooit geladen, ongeacht de instellingen.
De output die u vroeg
Bij sommige conversies werd een deel van het verzoek genegeerd. Diverse schreven altijd DOCX, XLSX, PPTX of een multi‑frame TIFF ongeacht het gekozen doelformaat, en paginaselectie werd genegeerd voor e‑mail, web en multi‑page TIFF naar tekstverwerking, voor Word Flat OPC‑documenten, en voor Project naar PS en PCL. Nu produceren ze allemaal wat de conversie‑opties vragen. Watermerken verschijnen nu ook bij het converteren van niet‑afbeeldingsdocumenten naar afbeeldingen en bij het converteren van CSV en TSV; MHT‑ en MHTML‑pagina’s worden gerenderd in plaats van hun MIME‑bron te tonen, en transparante achtergronden worden niet langer zwart in J2K, JP2, WMF en WMZ output.
Minder mislukte conversies
PostScript‑bestanden die de run‑ of file‑operator gebruiken op .NET Framework, PSD-, PSB- en AI‑documenten pagina voor pagina, volledige CAD‑tekeningen naar TeX, XHTML met inline SVG, PDF, XPS en SVG naar EPUB, en Visio en SVG naar spreadsheet converteren nu in plaats van te falen. In e‑mail-, mailbox‑ en archiefbestanden veroorzaakt een bijlage die niet naar het doelformaat kan worden geconverteerd niet langer dat de hele conversie mislukt, en een ingesloten document dat niet kan worden geladen wordt nu gerapporteerd via ConversionEvents.OnDocumentFailed.
Beveiliging, licenties en .NET Framework
- System.Security.Cryptography.Pkcs wordt bijgewerkt naar 8.0.2 (10.0.13 op .NET 10), waarmee CVE-2026-84008 en CVE-2026-70162 worden aangepakt.
- .NET Framework‑projecten falen niet meer bij het laden van RuntimeInformation of ValueTuple, en EML-, HTML- en CAD‑conversies falen niet meer op .NET Framework 4.6.2 tot 4.7.0.
- WebP‑conversies met een geldige licentie tonen niet langer het proefbadge. In evaluatiemodus geldt de limiet van 3 pagina’s nu ook voor SVG, SVGZ, PS en PCL output.
Wat is nieuw in deze release
- [Feature] Voeg een per‑resource callback toe om elke externe bron die een document laadt te inspecteren, toe te staan, te weigeren of te leveren
- [Improvement] Bied SvgLoadOptions aan als de laadopties voor SVG‑ en SVGZ‑documenten
- [Improvement] Benoem OLM‑ en NSF‑items zonder onderwerp op basis van map en positie en vermijd gereserveerde Windows‑apparaatnamen in mailbox‑itemnamen
- [Improvement] Rapporteer archief‑, e‑mail‑ en mailbox‑items die niet geladen kunnen worden aan de document‑failed handler in plaats van alleen te loggen
- [Bug] Proefbadge wordt toegepast bij conversie van Webp, zelfs wanneer een geldige licentie is toegepast
- [Bug] Specifieke VSDX‑bestandconversie – tekst buiten de vakgrenzen
- [Bug] Dubbele doorstreepte tekst wordt niet behouden bij ODT‑naar‑PDF‑conversie
- [Bug] Problemen bij VCF‑naar‑Excel‑conversie
- [Bug] Los conversies op die falen bij het laden van RuntimeInformation in oude .NET Framework‑projecten 4.7.1+ die PackageReference gebruiken
- [Bug] Los conversies op die falen bij het laden van RuntimeInformation of ValueTuple in .NET Framework‑projects met packages.config
- [Bug] Los EML-, HTML- en CAD‑conversies op die falen op .NET Framework 4.6.2 tot 4.7.0 runtimes
- [Bug] Het converteren van WordProcessing-, Pdf- en ProjectManagement‑documenten naar elk spreadsheet‑formaat produceert altijd XLSX
- [Bug] Het converteren van WordProcessing-, Pdf- en Diagram‑documenten naar elk presentatie‑formaat produceert altijd PPTX
- [Bug] Los PST-, OST- en MBOX‑conversie op die faalt bij een item zonder onderwerp en PST‑sticky‑notes die naar onleesbare tekst converteren
- [Bug] Het converteren van een één‑pagina document naar een niet‑TIFF‑afbeeldingsformaat produceert altijd een multi‑frame TIFF
- [Bug] [GroupDocs.Conversion for .NET] Update System.Security.Cryptography.Pkcs to 8.0.2 (CVE-2026-84008 / CVE-2026-70162)
- [Bug] Tekst‑ of afbeeldingswatermerk wordt niet toegepast bij het converteren van niet‑afbeeldingsdocumenten naar afbeeldingen
- [Bug] Transparante paginabackground wordt zwart bij conversie naar J2K, JP2, WMF en WMZ
- [Bug] WMZ‑output van Word‑gebaseerde documenten bevat een ge‑gzipte PNG en EMZ‑output van afbeeldingen wordt twee keer ge‑gzipte
- [Bug] MHT‑ en MHTML‑pagina’s die naar afbeeldingen worden geconverteerd tonen de MIME‑bron in plaats van de pagina
- [Bug] Document‑info van een Publisher‑document meldt altijd één pagina
- [Bug] Watermerk wordt niet toegepast bij het converteren van CSV‑ en TSV‑documenten
- [Bug] Laad externe bronnen alleen van exacte witgelijste URL‑prefixen en de eigen map van het document, nooit van UNC‑paden
- [Bug] Los CAD-, Image-, Diagram-, DjVu-, VCF- en Email‑naar‑WordProcessing op die DOCX opslaan voor elk doel behalve DOC
- [Bug] Los Email‑naar‑WordProcessing op die paginaselectie en paginabereik negeert
- [Bug] Los multi‑page TIFF‑naar‑WordProcessing op die paginaselectie negeert
- [Bug] Respecteer SkipExternalResources en WhitelistedResources bij het converteren van Markdown‑ en CHM‑documenten
- [Bug] Respecteer SkipExternalResources en WhitelistedResources bij e‑mail‑naar‑spreadsheet, spreadsheet‑ en paginabereik‑conversies
- [Bug] Laad standaard geen afbeeldingen van buiten de map van het document bij het converteren van HTML naar een spreadsheet
- [Bug] Laad standaard geen externe bronnen bij het converteren van SVG naar presentatie, tekstverwerking, spreadsheet, XPS of EPS
- [Bug] Laad standaard geen 3D‑materiaalbibliotheken, texturen en buffers van buiten de map van het model
- [Bug] Laad standaard geen externe afbeeldingen bij het converteren van XML via een XSL‑FO‑stylesheet
- [Bug] Los HTML‑ en MHTML‑naar‑WordProcessing op die DOCX opslaan voor elk doel
- [Bug] Laad standaard geen XBRL‑ en inline XBRL‑taxonomieën van buiten de map van het document
- [Bug] Stop met het uitvoeren van scripts en het downloaden van scriptbestanden bij het converteren van HTML-, XHTML- en SVG‑documenten
- [Bug] Los Web‑naar‑WordProcessing op die paginaselectie en paginabereik negeert
- [Bug] Los Word Flat OPC‑documenten op die paginaselectie en paginabereik negeert
- [Bug] Voeg standaard geen texturen van buiten de map van het model in bij het converteren van 3D‑documenten
- [Bug] Los single‑stream compressie‑archieven op die hun bestand zonder naam converteren
- [Bug] Los javascript:- en vbscript:-referenties op die worden opgehaald wanneer externe bronnen zijn toegestaan
- [Bug] Los XHTML‑documenten met inline SVG die niet converteren op
- [Bug] Los HTML‑naar‑HTML‑conversie op die faalt wanneer een relatieve CSS @import niet kan worden geladen
- [Bug] Los Visio‑ en SVG‑naar‑spreadsheet‑conversie op die faalt op een pagina zonder te tekenen
- [Bug] Los PDF-, XPS- en SVG‑naar‑EPUB‑conversie op die faalt op een hyperlink die geen tekst omvat
- [Bug] Los e‑mail-, mailbox‑ en archief‑conversie op die faalt op een bijlage die niet naar het doelformaat kan worden geconverteerd
- [Bug] Los PCL‑conversie op die Courier New en andere geïnstalleerde lettertypen vervangt na een PDF‑conversie
- [Bug] GroupDocs.Conversion.LowCode 26.9.0: DOCX naar PDF op Linux negeert lettertype‑substitutie en gebruikt het alfabetisch eerste lettertype
- [Bug] Los XML‑documentatiefouten op in GroupDocs.Conversion.LowCode 26.9.0
- [Bug] Los PostScript‑conversie op die faalt op .NET Framework wanneer een document de run‑ of file‑operator gebruikt
- [Bug] Los niet‑gelicentieerde conversies naar paginabeschrijvings‑taalformaten op die de proef‑paginalimiet negeren
- [Bug] Los pagina‑voor‑pagina conversie van PSD-, PSB- en Illustrator AI‑documenten op die falen met een uitzondering
- [Bug] Los conversie van video naar een audio‑formaat op die faalt zelfs wanneer een video‑connector is ingesteld
- [Bug] Los ProjectManagement‑naar‑PS en PCL‑conversie op die extra pagina’s produceert en paginaselectie negeert
- [Bug] Los ProjectManagement‑naar‑SVG op die UTF-16 schrijft zonder byte‑order‑mark
- [Bug] Los 3D‑naar‑glTF en OBJ‑conversie op die buffer‑ en materiaalbestanden in de werkmap schrijft
- [Bug] Los MHT‑ en MHTML‑conversies naar PDF, XPS, TeX en WordProcessing op die de MIME‑bron tonen in plaats van de pagina
- [Bug] Los CAD‑naar‑TeX‑conversie van een volledige tekening op die faalt met FileTypeNotSupported
- [Bug] Los PDL‑ en XML/JSON‑naar‑PS en PCL‑conversies op die extra pagina’s toevoegen
- [Bug] Los CAD‑naar‑PS en PCL‑conversies op die slechts één pagina van multi‑page DWF‑tekeningen behouden
- [Bug] Los MBOX‑conversie op die faalt of de e‑mail‑headers verwijdert wanneer een berichtonderwerp eruitziet als een bestandsnaam
Wijzigingen in de openbare API
Nieuwe API
IExternalResourceHandlerenExternalResourceLoadingArgs(Uri,Skipped,Data) in deGroupDocs.Conversion.Options.Loadnamespace.ExternalResourceHandleropIResourceLoadingOptionsen de laadopties die dit implementeren.ExecuteScriptsopWebLoadOptionsenSvgLoadOptions.SkipExternalResources,WhitelistedResourcesenExternalResourceHandleropFinanceLoadOptionsenThreeDLoadOptions, die nuIResourceLoadingOptionsimplementeren.
⚠️ Controleer vóór het upgraden
-
Externe bronnen: documenten die afhankelijk waren van lokale bestanden buiten hun map, UNC‑paden of scripts, converteren nu zonder deze. Sta toe wat u vertrouwt zoals beschreven in Veilige standaardinstellingen voor onbetrouwbare documenten.
-
Whitelist‑items: elk
WhitelistedResources‑item moet een absolute URI‑prefix zijn, zoalshttps://cdn.example.com/assets/offile:///C:/assets/. Items zoalsjpgofexample.com, die eerdere versies overal in de URL overeenkwamen, zorgen nu voor een fout bij het laden metInvalidLoadOptionsException. -
XBRL en inline XBRL: een filing waarvan de taxonomie buiten de map ligt, of die uit een stream wordt geladen, faalt nu met
InvalidLoadOptionsException. Laad filings die u vertrouwt als volgt:using (Converter converter = new Converter("filing.xbrl", (LoadContext loadContext) => new FinanceLoadOptions { SkipExternalResources = false })) { converter.Convert("filing.xlsx", new SpreadsheetConvertOptions()); } -
SVG en SVGZ: geconverteerd zonder laadopties, gebruiken ze nu
SvgLoadOptions, enPossibleConversions.LoadOptionsretourneertSvgLoadOptionsin plaats vanPageDescriptionLanguageLoadOptions. -
Uitvoerformaat en pagina’s: conversies respecteren nu het gevraagde formaat en de paginaselectie, zodat de output kan afwijken van eerdere versies voor dezelfde opties.
PublisherDocumentInfo.PagesCountretourneert nu het werkelijke aantal pagina’s. -
Aangepaste
IResourceLoadingOptions‑implementaties moeten de nieuweExternalResourceHandler‑eigenschap toevoegen.
De release notes vermelden elke wijziging met de exacte exceptieberichten.
Hoe u de update krijgt
NuGet
Upgrade naar het nieuwste GroupDocs.Conversion‑pakket via NuGet: GroupDocs.Conversion 26.10.0
dotnet add package GroupDocs.Conversion --version 26.10.0
Directe download
Download assemblies van de GroupDocs.Conversion for .NET 26.10 pagina
Bronnen
- Full Release Notes
- Documentation
- Network access and data privacy – wanneer de bibliotheek toegang heeft tot het netwerk en hoe u deze offline kunt uitvoeren
- Skip loading of external resources – standaardinstellingen, whitelist‑items, de per‑resource handler en scripts
- Migration notes – migreren naar 26.10
- Load options for different document types – Laadopties voor verschillende documenttypen
- GitHub examples – vertrouwde locaties, een per‑resource handler, scripts van vertrouwde HTML en XBRL met een externe taxonomie
- Free Support Forum – Gratis ondersteuningsforum