Kami senang mengumumkan rilis GroupDocs.Conversion for .NET v26.10, tersedia sejak Oktober 2026. Rilis ini memberikan kontrol atas apa yang diizinkan dokumen untuk dimuat: kode Anda kini dapat memutuskan setiap sumber daya eksternal yang diminta dokumen, dan pengaturan default aman untuk dokumen dari sumber yang tidak dikenal. Rilis ini juga membuat konversi menghormati format output dan pemilihan halaman yang diminta, memperbaiki berbagai kegagalan konversi serta masalah pemuatan .NET Framework, dan memperbarui dependensi yang sensitif terhadap keamanan — total 60 fitur, perbaikan, dan perbaikan bug.

Sorotan

Tentukan apa yang dapat dimuat setiap dokumen

Dokumen sering merujuk ke luar dirinya: gambar di CDN, stylesheet, skrip, tekstur 3D, taksonomi XBRL. Pada versi 26.10 Anda dapat melihat setiap permintaan ini dan memutuskan dalam kode. Implementasikan IExternalResourceHandler dan tetapkan melalui properti ExternalResourceHandler pada opsi pemuatan. Handler menerima setiap sumber daya dengan keputusan default yang sudah diisi, dan dapat mengizinkannya, melewatkannya, atau — untuk sebagian besar format — menyediakan kontennya sendiri, misalnya dari cache Anda, sehingga tidak ada yang diminta sama sekali.

Handler ini memuat gambar JPEG dari satu host tepercaya di atas apa yang diizinkan default:

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 ini bekerja dengan opsi pemuatan untuk web, XML, pengolahan kata, spreadsheet, CSV dan TSV, presentasi, e‑mail, SVG, keuangan, dan dokumen 3D.

Default aman untuk dokumen yang tidak tepercaya

Mengonversi file yang diunggah orang tidak boleh membuat server Anda membaca file lain atau menghubungi host sembarangan. Dengan pengaturan default, versi 26.10:

  • memuat file lokal hanya dari folder dokumen itu sendiri, dan tidak pernah dari jalur UNC;
  • tidak menjalankan skrip dalam dokumen HTML, MHTML, XHTML, dan SVG, serta tidak meminta file skrip;
  • menerapkan aturan yang sama pada konversi SVG, model 3D, XBRL, XSL‑FO, Markdown, dan e‑mail‑ke‑spreadsheet.

Ketika dokumen Anda memang membutuhkan sumber daya luar, izinkan dengan cara yang sesuai: daftarkan lokasi tepercaya di WhitelistedResources, putuskan per sumber daya dengan handler, atau setel SkipExternalResources = false untuk dokumen yang Anda percayai. Skrip hanya dijalankan ketika Anda mengatur ExecuteScripts = true pada WebLoadOptions atau SvgLoadOptions. Jalur UNC dan referensi javascript: atau vbscript: tidak pernah dimuat, apa pun pengaturannya.

Output yang Anda minta

Beberapa konversi mengabaikan sebagian permintaan. Beberapa selalu menulis DOCX, XLSX, PPTX, atau TIFF multi‑frame terlepas dari format target yang Anda pilih, dan pemilihan halaman diabaikan untuk e‑mail, web, dan TIFF multi‑halaman ke pengolahan kata, untuk dokumen Word Flat OPC, serta untuk Project ke PS dan PCL. Semua kini menghasilkan apa yang diminta oleh opsi konversi. Watermark kini juga muncul saat mengonversi dokumen non‑gambar ke gambar dan saat mengonversi CSV serta TSV, halaman MHT dan MHTML dirender alih-alih menampilkan sumber MIME mereka, dan latar belakang transparan tidak lagi menjadi hitam pada output J2K, JP2, WMF, dan WMZ.

Lebih sedikit konversi yang gagal

File PostScript yang menggunakan operator run atau file pada .NET Framework, dokumen PSD, PSB, dan AI halaman per halaman, gambar CAD seluruhnya ke TeX, XHTML dengan SVG inline, PDF, XPS, dan SVG ke EPUB, serta Visio dan SVG ke spreadsheet kini berhasil dikonversi alih-alih gagal. Pada e‑mail, mailbox, dan file arsip, lampiran yang tidak dapat dikonversi ke format target tidak lagi menyebabkan seluruh konversi gagal, dan dokumen yang tidak dapat dimuat kini dilaporkan melalui ConversionEvents.OnDocumentFailed.

Keamanan, lisensi, dan .NET Framework

  • System.Security.Cryptography.Pkcs berpindah ke 8.0.2 (10.0.13 pada .NET 10), menangani CVE-2026-84008 dan CVE-2026-70162.
  • Proyek .NET Framework tidak lagi gagal memuat RuntimeInformation atau ValueTuple, dan konversi EML, HTML, serta CAD tidak lagi gagal pada .NET Framework 4.6.2 hingga 4.7.0.
  • Konversi WebP dengan lisensi yang valid tidak lagi menampilkan badge percobaan. Dalam mode evaluasi, batas 3 halaman kini juga berlaku untuk output SVG, SVGZ, PS, dan PCL.

Apa yang baru dalam rilis ini

  • [Feature] Tambahkan callback per sumber daya untuk memeriksa, mengizinkan, menolak, atau menyediakan setiap sumber daya eksternal yang dimuat dokumen
  • [Improvement] Tawarkan SvgLoadOptions sebagai opsi pemuatan untuk dokumen SVG dan SVGZ
  • [Improvement] Namai item OLM dan NSF tanpa subjek berdasarkan folder dan posisi serta hindari nama perangkat Windows yang dipesan dalam nama item mailbox
  • [Improvement] Laporkan item arsip, email, dan mailbox yang tidak dapat dimuat ke handler document‑failed alih-alih hanya mencatatnya
  • [Bug] Badge percobaan diterapkan saat mengonversi dari Webp meskipun lisensi valid sudah diterapkan
  • [Bug] Konversi file VSDX spesifik – teks di luar batas kotak
  • [Bug] Teks coret ganda tidak dipertahankan dalam konversi ODT ke PDF
  • [Bug] Masalah konversi VCF ke Excel
  • [Bug] Perbaiki konversi yang gagal memuat RuntimeInformation pada proyek .NET Framework gaya lama 4.7.1+ yang menggunakan PackageReference
  • [Bug] Perbaiki konversi yang gagal memuat RuntimeInformation atau ValueTuple pada proyek .NET Framework packages.config
  • [Bug] Perbaiki konversi EML, HTML, dan CAD yang gagal pada runtime .NET Framework 4.6.2 hingga 4.7.0
  • [Bug] Mengonversi dokumen WordProcessing, Pdf, dan ProjectManagement ke format spreadsheet apa pun selalu menghasilkan XLSX
  • [Bug] Mengonversi dokumen WordProcessing, Pdf, dan Diagram ke format presentasi apa pun selalu menghasilkan PPTX
  • [Bug] Perbaiki konversi PST, OST, dan MBOX yang gagal pada item tanpa subjek serta catatan tempel PST yang menjadi teks tidak terbaca
  • [Bug] Mengonversi dokumen satu halaman ke format gambar non‑TIFF selalu menghasilkan TIFF multi‑frame
  • [Bug] [GroupDocs.Conversion for .NET] Perbarui System.Security.Cryptography.Pkcs ke 8.0.2 (CVE-2026-84008 / CVE-2026-70162)
  • [Bug] Watermark teks atau gambar tidak diterapkan saat mengonversi dokumen non‑gambar ke gambar
  • [Bug] Latar belakang halaman transparan menjadi hitam saat mengonversi ke J2K, JP2, WMF, dan WMZ
  • [Bug] Output WMZ dokumen berbasis Word berisi PNG terkompresi gzip dan output EMZ gambar terkompresi dua kali
  • [Bug] Halaman MHT dan MHTML yang dikonversi ke gambar menampilkan sumber MIME alih-alih halaman
  • [Bug] Info dokumen Publisher selalu melaporkan satu halaman
  • [Bug] Watermark tidak diterapkan saat mengonversi dokumen CSV dan TSV
  • [Bug] Muat sumber daya eksternal hanya dari prefiks URL yang masuk whitelist tepat dan folder dokumen sendiri, tidak pernah dari jalur UNC
  • [Bug] Perbaiki CAD, Image, Diagram, DjVu, VCF, dan Email ke WordProcessing yang menyimpan DOCX untuk setiap target kecuali DOC
  • [Bug] Perbaiki Email ke WordProcessing yang mengabaikan pemilihan halaman dan rentang halaman
  • [Bug] Perbaiki TIFF multi‑halaman ke WordProcessing yang mengabaikan pemilihan halaman
  • [Bug] Hormati SkipExternalResources dan WhitelistedResources saat mengonversi dokumen Markdown dan CHM
  • [Bug] Hormati SkipExternalResources dan WhitelistedResources dalam konversi email‑ke‑spreadsheet, spreadsheet, dan rentang halaman
  • [Bug] Jangan muat gambar dari luar folder dokumen secara default saat mengonversi HTML ke spreadsheet
  • [Bug] Jangan muat sumber daya eksternal secara default saat mengonversi SVG ke presentasi, pengolahan kata, spreadsheet, XPS, atau EPS
  • [Bug] Jangan muat perpustakaan material 3D, tekstur, dan buffer dari luar folder model secara default
  • [Bug] Jangan muat gambar eksternal secara default saat mengonversi XML melalui stylesheet XSL‑FO
  • [Bug] Perbaiki HTML dan MHTML ke WordProcessing yang menyimpan DOCX untuk setiap target
  • [Bug] Jangan muat taksonomi XBRL dan XBRL inline dari luar folder dokumen secara default
  • [Bug] Hentikan menjalankan skrip dan mengunduh file skrip saat mengonversi dokumen HTML, XHTML, dan SVG
  • [Bug] Perbaiki Web ke WordProcessing yang mengabaikan pemilihan halaman dan rentang halaman
  • [Bug] Perbaiki dokumen Word Flat OPC yang mengabaikan pemilihan halaman dan rentang halaman
  • [Bug] Jangan sematkan tekstur dari luar folder model secara default saat mengonversi dokumen 3D
  • [Bug] Perbaiki arsip kompresi satu‑stream yang mengonversi file tanpa nama
  • [Bug] Perbaiki referensi javascript: dan vbscript: yang diambil ketika sumber daya eksternal diizinkan
  • [Bug] Perbaiki dokumen XHTML dengan SVG inline yang gagal dikonversi
  • [Bug] Perbaiki konversi HTML ke HTML yang gagal ketika CSS @import relatif tidak dapat dimuat
  • [Bug] Perbaiki konversi Visio dan SVG ke spreadsheet yang gagal pada halaman tanpa apa‑apa untuk digambar
  • [Bug] Perbaiki konversi PDF, XPS, dan SVG ke EPUB yang gagal pada hyperlink yang tidak mencakup teks
  • [Bug] Perbaiki konversi email, mailbox, dan arsip yang gagal pada lampiran yang tidak dapat dikonversi ke format target
  • [Bug] Perbaiki konversi PCL yang menggantikan Courier New dan font terpasang lainnya setelah PDF dikonversi
  • [Bug] GroupDocs.Conversion.LowCode 26.9.0: DOCX ke PDF pada Linux mengabaikan substitusi font dan menggunakan font pertama secara alfabetis
  • [Bug] Perbaiki kesalahan dokumentasi XML pada GroupDocs.Conversion.LowCode 26.9.0
  • [Bug] Perbaiki konversi PostScript yang gagal pada .NET Framework ketika dokumen menggunakan operator run atau file
  • [Bug] Perbaiki konversi tidak berlisensi ke format bahasa deskripsi halaman yang mengabaikan batas halaman percobaan
  • [Bug] Perbaiki konversi halaman per halaman dokumen PSD, PSB, dan Illustrator AI yang gagal dengan pengecualian
  • [Bug] Perbaiki konversi video ke format audio yang gagal meskipun konektor video sudah disetel
  • [Bug] Perbaiki konversi ProjectManagement ke PS dan PCL yang menghasilkan halaman ekstra dan mengabaikan pemilihan halaman
  • [Bug] Perbaiki ProjectManagement ke SVG yang menulis UTF‑16 tanpa byte order mark
  • [Bug] Perbaiki konversi 3D ke glTF dan OBJ yang menulis file buffer dan material ke direktori kerja
  • [Bug] Perbaiki konversi MHT dan MHTML ke PDF, XPS, TeX, dan WordProcessing yang menampilkan sumber MIME alih-alih halaman
  • [Bug] Perbaiki konversi CAD ke TeX seluruh gambar yang gagal dengan FileTypeNotSupported
  • [Bug] Perbaiki konversi PDL serta XML/JSON ke PS dan PCL yang menambahkan halaman ekstra
  • [Bug] Perbaiki konversi CAD ke PS dan PCL yang hanya menyimpan satu halaman dari gambar DWF multi‑halaman
  • [Bug] Perbaiki konversi MBOX yang gagal atau menghilangkan header email ketika subjek pesan tampak seperti nama file

Perubahan API Publik

API Baru

  • IExternalResourceHandler dan ExternalResourceLoadingArgs (Uri, Skipped, Data) di namespace GroupDocs.Conversion.Options.Load.
  • ExternalResourceHandler pada IResourceLoadingOptions dan opsi pemuatan yang mengimplementasikannya.
  • ExecuteScripts pada WebLoadOptions dan SvgLoadOptions.
  • SkipExternalResources, WhitelistedResources, dan ExternalResourceHandler pada FinanceLoadOptions serta ThreeDLoadOptions, yang kini mengimplementasikan IResourceLoadingOptions.

⚠️ Periksa sebelum Anda memperbarui

  • Sumber daya eksternal: dokumen yang bergantung pada file lokal di luar foldernya, jalur UNC, atau skrip kini dapat dikonversi tanpa mereka. Izinkan apa yang Anda percayai sebagaimana dijelaskan di Default aman untuk dokumen yang tidak tepercaya.

  • Entri whitelist: setiap entri WhitelistedResources harus berupa prefiks URI absolut, seperti https://cdn.example.com/assets/ atau file:///C:/assets/. Entri seperti jpg atau example.com, yang pada versi sebelumnya cocok di mana saja dalam URL, kini menyebabkan pemuatan gagal dengan InvalidLoadOptionsException.

  • XBRL dan XBRL inline: pengajuan yang taksonominya berada di luar foldernya, atau yang dimuat dari stream, kini gagal dimuat dengan InvalidLoadOptionsException. Muat pengajuan yang Anda percayai seperti ini:

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

  • SVG dan SVGZ: dikonversi tanpa opsi pemuatan, kini menggunakan SvgLoadOptions, dan PossibleConversions.LoadOptions mengembalikan SvgLoadOptions alih-alih PageDescriptionLanguageLoadOptions.

  • Format output dan halaman: konversi kini menghormati format yang diminta dan pemilihan halaman, sehingga output dapat berbeda dari versi sebelumnya untuk opsi yang sama. PublisherDocumentInfo.PagesCount kini mengembalikan jumlah halaman sebenarnya.

  • Implementasi IResourceLoadingOptions khusus harus menambahkan properti ExternalResourceHandler yang baru.

Catatan rilis lengkap dapat dilihat pada release notes yang mencantumkan setiap perubahan beserta pesan pengecualian yang tepat.

Cara mendapatkan pembaruan

NuGet

Tingkatkan ke paket GroupDocs.Conversion terbaru melalui NuGet: GroupDocs.Conversion 26.10.0

dotnet add package GroupDocs.Conversion --version 26.10.0

Unduhan langsung

Unduh assembly dari halaman GroupDocs.Conversion for .NET 26.10

Sumber Daya