Z przyjemnością ogłaszamy wydanie GroupDocs.Conversion for .NET v26.10, dostępne od października 2026. To wydanie dotyczy kontroli nad tym, co dokument może ładować: Twój kod może teraz decydować o każdym zewnętrznym zasobie, o który prosi dokument, a domyślne ustawienia są bezpieczne dla dokumentów pochodzących z nieznanych źródeł. Zapewnia również, że konwersje respektują żądany format wyjściowy i wybór stron, naprawia szereg błędów konwersji i problemów z ładowaniem w .NET Framework oraz aktualizuje wrażliwą na bezpieczeństwo zależność — łącznie 60 funkcji, ulepszeń i poprawek błędów.
Najważniejsze
Decyzja, co każdy dokument może ładować
Dokumenty często odwołują się do zasobów zewnętrznych: obrazy z CDN, arkusze stylów, skrypty, tekstury 3D, taksonomie XBRL. W wersji 26.10 możesz zobaczyć każde z tych żądań i podjąć decyzję w kodzie. Zaimplementuj IExternalResourceHandler i ustaw go poprzez właściwość ExternalResourceHandler w opcjach ładowania. Obsługa otrzymuje każdy zasób z już wypełnioną domyślną decyzją i może go zezwolić, pominąć lub — w większości formatów — dostarczyć samą treść, na przykład z własnej pamięci podręcznej, tak aby nic nie było żądane.
Ten handler ładuje obrazy JPEG z jednego zaufanego hosta, ponad to, co pozwalają domyślne ustawienia:
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());
}
Obsługa działa z opcjami ładowania dla dokumentów web, XML, przetwarzania tekstu, arkuszy kalkulacyjnych, CSV i TSV, prezentacji, e‑mail, SVG, finansowych i 3D.
Bezpieczne domyślne ustawienia dla niezaufanych dokumentów
Konwertowanie pliku przesłanego przez kogoś nie powinno powodować, że Twój serwer odczytuje inne pliki lub łączy się z dowolnymi hostami. Z domyślnymi ustawieniami, 26.10:
- ładuje pliki lokalne wyłącznie z własnego folderu dokumentu i nigdy z ścieżek UNC;
- nie uruchamia skryptów w dokumentach HTML, MHTML, XHTML i SVG oraz nie żąda plików skryptów;
- stosuje te same zasady do konwersji SVG, modeli 3D, XBRL, XSL-FO, Markdown oraz e‑mail do arkusza kalkulacyjnego.
Kiedy Twoje dokumenty rzeczywiście potrzebują zasobów zewnętrznych, zezwól na nie w odpowiedni sposób: wymień zaufane lokalizacje w WhitelistedResources, decyduj o każdym zasobie przy pomocy handlera lub ustaw SkipExternalResources = false dla dokumentów, którym ufasz. Skrypty są uruchamiane tylko wtedy, gdy ustawisz ExecuteScripts = true w WebLoadOptions lub SvgLoadOptions. Ścieżki UNC oraz odwołania javascript: lub vbscript: nigdy nie są ładowane, niezależnie od ustawień.
Wyjście, o które prosiłeś
Niektóre konwersje ignorowały część żądania. Kilka zawsze zapisywało DOCX, XLSX, PPTX lub wieloklatkowy TIFF, niezależnie od wybranego formatu docelowego, a wybór stron był ignorowany przy konwersji e‑mail, web i wieloklatkowego TIFF do przetwarzania tekstu, dla dokumentów Word Flat OPC oraz dla Project do PS i PCL. Wszystkie teraz generują to, o co proszą opcje konwersji. Znaki wodne pojawiają się teraz także przy konwersji dokumentów nie‑obrazowych na obrazy oraz przy konwersji CSV i TSV, a strony MHT i MHTML są renderowane zamiast wyświetlania ich źródła MIME; przezroczyste tła nie zamieniają się już na czarne w wyjściach J2K, JP2, WMF i WMZ.
Mniej nieudanych konwersji
Pliki PostScript używające operatora run lub file w .NET Framework, dokumenty PSD, PSB i AI strona po stronie, całe rysunki CAD do TeX, XHTML z wbudowanym SVG, PDF, XPS i SVG do EPUB oraz Visio i SVG do arkusza kalkulacyjnego teraz konwertują zamiast kończyć się niepowodzeniem. W plikach e‑mail, skrzynkach pocztowych i archiwach załącznik, którego nie można przekonwertować na format docelowy, nie powoduje już niepowodzenia całej konwersji, a zawarty dokument, którego nie można załadować, jest teraz zgłaszany poprzez ConversionEvents.OnDocumentFailed.
Bezpieczeństwo, licencjonowanie i .NET Framework
- System.Security.Cryptography.Pkcs przechodzi do wersji 8.0.2 (10.0.13 w .NET 10), rozwiązując CVE-2026-84008 i CVE-2026-70162.
- .NET Framework projekty nie przestają ładować RuntimeInformation ani ValueTuple, a konwersje EML, HTML i CAD nie kończą się już niepowodzeniem w .NET Framework 4.6.2‑4.7.0.
- Konwersje WebP z ważną licencją nie wyświetlają już odznaki wersji próbnej. W trybie ewaluacji limit 3 stron obowiązuje teraz także dla wyjść SVG, SVGZ, PS i PCL.
Co nowego w tym wydaniu
- [Feature] Dodaj wywołanie zwrotne per‑zasób, aby sprawdzić, zezwolić, odmówić lub dostarczyć każdy zewnętrzny zasób ładowany przez dokument
- [Improvement] Udostępnij SvgLoadOptions jako opcje ładowania dla dokumentów SVG i SVGZ
- [Improvement] Nazwij elementy OLM i NSF bez tematu według folderu i pozycji oraz unikaj zastrzeżonych nazw urządzeń Windows w nazwach elementów skrzynki pocztowej
- [Improvement] Zgłaszaj elementy archiwum, e‑mail i skrzynki pocztowej, których nie można załadować, do obsługi document‑failed zamiast jedynie logować je
- [Bug] Odznaka wersji próbnej jest stosowana przy konwersji z Webp, nawet gdy zastosowano ważną licencję
- [Bug] Konwersja konkretnego pliku VSDX – tekst poza granicami ramki
- [Bug] Podwójne przekreślenie tekstu nie jest zachowywane przy konwersji ODT do PDF
- [Bug] Problemy z konwersją VCF do Excel
- [Bug] Napraw konwersje nieładujące RuntimeInformation w starszych projektach .NET Framework 4.7.1+ używających PackageReference
- [Bug] Napraw konwersje nieładujące RuntimeInformation lub ValueTuple w projektach .NET Framework z packages.config
- [Bug] Napraw konwersje EML, HTML i CAD niepowodujące się w środowiskach .NET Framework 4.6.2‑4.7.0
- [Bug] Konwersja dokumentów WordProcessing, Pdf i ProjectManagement do dowolnego formatu arkusza kalkulacyjnego zawsze generuje XLSX
- [Bug] Konwersja dokumentów WordProcessing, Pdf i Diagram do dowolnego formatu prezentacji zawsze generuje PPTX
- [Bug] Napraw konwersję PST, OST i MBOX, które nie powiodły się przy elemencie bez tematu oraz notatki PST konwertujące się na nieczytelny tekst
- [Bug] Konwersja jednostronicznego dokumentu do formatu obrazu nie‑TIFF zawsze generuje wieloklatkowy TIFF
- [Bug] [GroupDocs.Conversion for .NET] Aktualizacja System.Security.Cryptography.Pkcs do 8.0.2 (CVE-2026-84008 / CVE-2026-70162)
- [Bug] Znak wodny tekstowy lub graficzny nie jest stosowany przy konwersji dokumentów nie‑obrazowych na obrazy
- [Bug] Przezroczyste tło strony zamienia się na czarne przy konwersji do J2K, JP2, WMF i WMZ
- [Bug] Wyjście WMZ dokumentów opartych na Word zawiera spakowany gzipem PNG, a wyjście EMZ obrazów jest spakowane gzipem dwukrotnie
- [Bug] Strony MHT i MHTML konwertowane na obrazy wyświetlają źródło MIME zamiast strony
- [Bug] Informacje o dokumencie Publisher zawsze podają jedną stronę
- [Bug] Znak wodny nie jest stosowany przy konwersji dokumentów CSV i TSV
- [Bug] Ładuj zasoby zewnętrzne wyłącznie z dokładnych prefiksów URL znajdujących się na białej liście oraz z własnego folderu dokumentu, nigdy z ścieżek UNC
- [Bug] Napraw konwersję CAD, Image, Diagram, DjVu, VCF i Email do WordProcessing, zapisującą DOCX dla każdego celu oprócz DOC
- [Bug] Napraw konwersję Email do WordProcessing ignorującą wybór stron i zakres stron
- [Bug] Napraw konwersję wieloklatkowego TIFF do WordProcessing ignorującą wybór stron
- [Bug] Szanuj SkipExternalResources i WhitelistedResources przy konwersji dokumentów Markdown i CHM
- [Bug] Szanuj SkipExternalResources i WhitelistedResources w konwersjach e‑mail‑do‑arkusza, arkusza i zakresu stron
- [Bug] Domyślnie nie ładuj obrazów spoza folderu dokumentu przy konwersji HTML do arkusza kalkulacyjnego
- [Bug] Domyślnie nie ładuj zasobów zewnętrznych przy konwersji SVG do prezentacji, przetwarzania tekstu, arkusza kalkulacyjnego, XPS lub EPS
- [Bug] Domyślnie nie ładuj bibliotek materiałów 3D, tekstur i buforów spoza folderu modelu
- [Bug] Domyślnie nie ładuj zewnętrznych obrazów przy konwersji XML przy użyciu arkusza stylów XSL-FO
- [Bug] Napraw konwersję HTML i MHTML do WordProcessing, zapisującą DOCX dla każdego celu
- [Bug] Domyślnie nie ładuj taksonomii XBRL i wbudowanych XBRL spoza folderu dokumentu
- [Bug] Zaprzestań uruchamiania skryptów i pobierania plików skryptów przy konwersji dokumentów HTML, XHTML i SVG
- [Bug] Napraw konwersję Web do WordProcessing ignorującą wybór stron i zakres stron
- [Bug] Napraw dokumenty Word Flat OPC ignorujące wybór stron i zakres stron
- [Bug] Domyślnie nie osadzaj tekstur spoza folderu modelu przy konwersji dokumentów 3D
- [Bug] Napraw archiwa kompresji jednoprzepływowej konwertujące plik bez nazwy
- [Bug] Napraw pobieranie odwołań javascript: i vbscript: gdy zasoby zewnętrzne są dozwolone
- [Bug] Napraw niepowodzenie konwersji dokumentów XHTML z wbudowanym SVG
- [Bug] Napraw niepowodzenie konwersji HTML do HTML, gdy względny CSS @import nie może zostać załadowany
- [Bug] Napraw niepowodzenie konwersji Visio i SVG do arkusza kalkulacyjnego na stronie bez elementów do rysowania
- [Bug] Napraw niepowodzenie konwersji PDF, XPS i SVG do EPUB przy hiperłączu nie obejmującym tekstu
- [Bug] Napraw niepowodzenie konwersji e‑mail, skrzynki pocztowej i archiwum przy załączniku, którego nie można przekonwertować na format docelowy
- [Bug] Napraw konwersję PCL, która zastępowała Courier New i inne zainstalowane czcionki po konwersji PDF
- [Bug] GroupDocs.Conversion.LowCode 26.9.0: DOCX do PDF w systemie Linux ignoruje podstawienie czcionki i używa pierwszej czcionki alfabetycznie
- [Bug] Napraw błędy dokumentacji XML w GroupDocs.Conversion.LowCode 26.9.0
- [Bug] Napraw niepowodzenie konwersji PostScript w .NET Framework, gdy dokument używa operatora run lub file
- [Bug] Napraw nielicencjonowane konwersje do formatów języka opisu strony ignorujące limit wersji próbnej
- [Bug] Napraw konwersję strona po stronie dokumentów PSD, PSB i Illustrator AI, która kończyła się wyjątkiem
- [Bug] Napraw niepowodzenie konwersji wideo do formatu audio, nawet gdy ustawiono łącznik wideo
- [Bug] Napraw konwersję ProjectManagement do PS i PCL, generującą dodatkowe strony i ignorującą wybór stron
- [Bug] Napraw konwersję ProjectManagement do SVG zapisującą UTF-16 bez znacznika kolejności bajtów
- [Bug] Napraw konwersję 3D do glTF i OBJ zapisującą pliki bufora i materiału w katalogu roboczym
- [Bug] Napraw konwersje MHT i MHTML do PDF, XPS, TeX i WordProcessing wyświetlające źródło MIME zamiast strony
- [Bug] Napraw konwersję CAD do TeX całego rysunku, która kończyła się błędem FileTypeNotSupported
- [Bug] Napraw konwersje PDL i XML/JSON do PS i PCL, które dodawały dodatkowe strony
- [Bug] Napraw konwersję CAD do PS i PCL, zachowującą tylko jedną stronę wielostronicowych rysunków DWF
- [Bug] Napraw niepowodzenie konwersji MBOX lub utratę nagłówków e‑mail, gdy temat wiadomości wygląda jak nazwa pliku
Zmiany w publicznym API
Nowe API
IExternalResourceHandleriExternalResourceLoadingArgs(Uri,Skipped,Data) w przestrzeni nazwGroupDocs.Conversion.Options.Load.ExternalResourceHandlerwIResourceLoadingOptionsoraz w opcjach ładowania, które go implementują.ExecuteScriptswWebLoadOptionsiSvgLoadOptions.SkipExternalResources,WhitelistedResourcesiExternalResourceHandlerwFinanceLoadOptionsiThreeDLoadOptions, które teraz implementująIResourceLoadingOptions.
⚠️ Sprawdź przed aktualizacją
-
Zasoby zewnętrzne: dokumenty, które polegały na lokalnych plikach poza ich folderem, ścieżkach UNC lub skryptach, teraz konwertują bez nich. Zezwalaj na to, co ufasz, jak opisano w Bezpieczne domyślne ustawienia dla niezaufanych dokumentów.
-
Pozycje białej listy: każdy wpis
WhitelistedResourcesmusi być absolutnym prefiksem URI, takim jakhttps://cdn.example.com/assets/lubfile:///C:/assets/. Pozycje takie jakjpgczyexample.com, które w poprzednich wersjach pasowały do dowolnego miejsca w URL, teraz powodują błąd ładowania zInvalidLoadOptionsException. -
XBRL i inline XBRL: sprawozdanie, którego taksonomia znajduje się poza jego folderem, lub załadowane ze strumienia, teraz nie ładuje się i zwraca
InvalidLoadOptionsException. Ładuj sprawozdania, którym ufasz, w ten sposób:using (Converter converter = new Converter("filing.xbrl", (LoadContext loadContext) => new FinanceLoadOptions { SkipExternalResources = false })) { converter.Convert("filing.xlsx", new SpreadsheetConvertOptions()); } -
SVG i SVGZ: konwertowane bez opcji ładowania, teraz używają
SvgLoadOptions, aPossibleConversions.LoadOptionszwracaSvgLoadOptionszamiastPageDescriptionLanguageLoadOptions. -
Format wyjściowy i strony: konwersje teraz respektują żądany format i wybór stron, więc wyjście może różnić się od wcześniejszych wersji przy tych samych opcjach.
PublisherDocumentInfo.PagesCountteraz zwraca rzeczywistą liczbę stron. -
Własne implementacje
IResourceLoadingOptionsmuszą dodać nową właściwośćExternalResourceHandler.
Notatki wydania (release notes) wymieniają każdą zmianę wraz z dokładnymi komunikatami wyjątków.
Jak uzyskać aktualizację
NuGet
Uaktualnij do najnowszego pakietu GroupDocs.Conversion za pośrednictwem NuGet: GroupDocs.Conversion 26.10.0
dotnet add package GroupDocs.Conversion --version 26.10.0
Bezpośrednie pobranie
Pobierz zestawy z strony GroupDocs.Conversion for .NET 26.10
Zasoby
- Pełne notatki wydania
- Dokumentacja
- Dostęp do sieci i prywatność danych – kiedy biblioteka uzyskuje dostęp do sieci i jak uruchomić ją offline
- Pomiń ładowanie zasobów zewnętrznych – domyślne ustawienia, pozycje białej listy, handler per‑zasób i skrypty
- Notatki migracyjne – migracja do 26.10
- Opcje ładowania dla różnych typów dokumentów
- Przykłady GitHub – zaufane lokalizacje, handler per‑zasób, skrypty zaufanego HTML i XBRL z zdalną taksonomią
- Free Support Forum