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

  • IExternalResourceHandler i ExternalResourceLoadingArgs (Uri, Skipped, Data) w przestrzeni nazw GroupDocs.Conversion.Options.Load.
  • ExternalResourceHandler w IResourceLoadingOptions oraz w opcjach ładowania, które go implementują.
  • ExecuteScripts w WebLoadOptions i SvgLoadOptions.
  • SkipExternalResources, WhitelistedResources i ExternalResourceHandler w FinanceLoadOptions i ThreeDLoadOptions, 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 WhitelistedResources musi być absolutnym prefiksem URI, takim jak https://cdn.example.com/assets/ lub file:///C:/assets/. Pozycje takie jak jpg czy example.com, które w poprzednich wersjach pasowały do dowolnego miejsca w URL, teraz powodują błąd ładowania z InvalidLoadOptionsException.

  • 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, a PossibleConversions.LoadOptions zwraca SvgLoadOptions zamiast PageDescriptionLanguageLoadOptions.

  • 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.PagesCount teraz zwraca rzeczywistą liczbę stron.

  • Własne implementacje IResourceLoadingOptions muszą 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