Kami dengan senang hati mengumumkan rilis GroupDocs.Conversion untuk .NET v26.9, tersedia sejak September 2026. Rilis ini memperkenalkan dukungan untuk format GIS dan kompresi baru, memungkinkan konversi presentasi menjadi slideshow HTML yang berdiri sendiri, meningkatkan penanganan TIFF multi‑halaman, dan memberlakukan batas evaluasi 10 konversi per proses. Rilis ini juga menghapus anggota API yang usang dan menerapkan validasi yang lebih ketat untuk opsi yang saling bertentangan.
Apa yang baru di rilis ini
- [Feature] Tambahkan WIM sebagai sumber konversi untuk dokumen kompresi (CONVERSIONNET-8488)
- [Feature] Tambahkan Apple Archive (AAR) sebagai sumber dan target konversi untuk dokumen kompresi (CONVERSIONNET-8491)
- [Feature] Tambahkan ALZ sebagai sumber konversi untuk dokumen kompresi (CONVERSIONNET-8494)
- [Feature] Tambahkan GeoJSON Text Sequence sebagai sumber konversi untuk dokumen GIS (CONVERSIONNET-8508)
- [Feature] Tambahkan KMZ sebagai sumber konversi untuk dokumen GIS (CONVERSIONNET-8510)
- [Feature] Tambahkan dukungan konversi GIS ke target framework net462 (CONVERSIONNET-8511)
- [Feature] Tambahkan GML dan OSM XML sebagai target konversi untuk dokumen GIS (CONVERSIONNET-8512)
- [Feature] Konversi presentasi menjadi slideshow HTML yang berdiri sendiri (CONVERSIONNET-8529)
- [Improvement] Terapkan ukuran halaman dan resolusi masing‑masing frame saat mengonversi TIFF multi‑halaman ke PDF (CONVERSIONNET-8519)
- [Improvement] Terapkan ukuran halaman dan resolusi masing‑masing frame saat mengonversi TIFF multi‑halaman halaman per halaman (CONVERSIONNET-8520)
- [Improvement] Terapkan ukuran halaman dan resolusi masing‑masing frame saat mengonversi TIFF multi‑halaman ke PDF ber‑tag (CONVERSIONNET-8521)
- [Improvement] Batasi mode evaluasi menjadi 10 konversi per proses (CONVERSIONNET-8523)
- [Improvement] Hapus listener konverter yang usang, tahap handler fluent, dan properti ukuran halaman (CONVERSIONNET-8561)
- [Bug] PPTX ke PDF: underline ganda dan strikethrough ganda menghasilkan koordinat NaN di Linux (CONVERSIONNET-8388)
- [Bug] Mengonversi PDF dengan lebih dari 4 halaman gagal dalam mode evaluasi (CONVERSIONNET-8515)
- [Bug] Batas halaman percobaan tidak diterapkan saat mengonversi PDF ke Web (CONVERSIONNET-8516)
- [Bug] Mengembalikan jumlah halaman yang benar untuk TIFF multi‑halaman (CONVERSIONNET-8522)
Perubahan API Publik
Perubahan yang Mematahkan
Anggota yang ditandai usang pada versi sebelumnya telah dihapus:
| Dihapus | Pengganti |
|---|---|
IConverterListener dan ConverterSettings.Listener |
ConversionEvents OnConversionStarted / OnConversionProgress / OnConversionCompleted |
ConverterSettings.OnConversionFailed |
ConversionEvents.OnDocumentFailed |
ConverterSettings.OnConversionByPageFailed |
ConversionEvents.OnPageFailed |
ConverterSettings.OnCompressionCompleted |
ConversionEvents.OnCompressionCompleted |
Fluent .OnCompressionCompleted(...) setelah .Compress(...) (IConversionCompressResultCompleted) |
FluentConverter.WithEvents(e => e.OnCompressionCompleted = ...) |
Antarmuka fluent IConversionHandlerSetup, IConversionHandlerFailed, IConversionHandlerCompleted |
IConversionHandlersStage |
Antarmuka fluent IConversionByPageHandlerSetup, IConversionByPageHandlerFailed, IConversionByPageHandlerCompleted |
IConversionByPageHandlersStage |
CadConvertOptions.PageSize / PageWidth / PageHeight |
CadConvertOptions.SizeSettings (PageSizeOptions) |
EBookConvertOptions.PageSize / PageWidth / PageHeight |
EBookConvertOptions.SizeSettings (PageSizeOptions) |
Dalam API fluent, WithOptions(...) kini mengembalikan IConversionHandlersStage (atau IConversionByPageHandlersStage untuk konversi halaman per halaman). Pemanggilan berantai seperti .WithOptions(...).OnConversionCompleted(...).OnConversionFailed(...).Convert() tetap dapat dikompilasi tanpa perubahan.
Ukuran halaman kini hanya diatur melalui SizeSettings:
var options = new CadConvertOptions
{
SizeSettings = new PageSizeOptions { PageWidth = 800, PageHeight = 600 }
};
Batas konversi mode evaluasi
Tanpa lisensi yang valid, sebuah proses dapat melakukan maksimal 10 konversi. Setiap pemanggilan Converter.Convert(...) dihitung sebagai satu konversi — termasuk semua overload, API fluent, dan pemanggilan yang gagal — terlepas dari berapa banyak file output yang dihasilkan. Converter.GetDocumentInfo() dan Converter.IsDocumentPasswordProtected() tidak dihitung. Hitungan ini melekat pada proses yang sedang berjalan; memulai ulang aplikasi akan mengatur ulang hitungan. Setelah lisensi yang valid diterapkan, konversi tidak lagi dihitung atau dibatasi.
Konversi ke‑11 akan melempar EvaluationLimitReachedException (turunan dari GroupDocsConversionException) dengan pesan:
Anda sedang menggunakan GroupDocs.Conversion dalam mode evaluasi: batas 10 dokumen yang dikonversi per proses telah tercapai. Dapatkan lisensi sementara gratis selama 30 hari untuk menghapus semua batas evaluasi: https://purchase.groupdocs.com/temporary-license/
Terapkan License atau kunci Metered sebelum konversi pertama untuk menghapus batas:
License license = new License();
license.SetLicense("GroupDocs.Conversion.lic");
using (Converter converter = new Converter("sample.docx"))
{
converter.Convert("converted.pdf", new PdfConvertOptions());
}
Kode yang dijalankan tanpa lisensi dapat menangani batas tersebut:
try
{
using (Converter converter = new Converter("sample.docx"))
{
converter.Convert("converted.pdf", new PdfConvertOptions());
}
}
catch (EvaluationLimitReachedException ex)
{
Console.WriteLine(ex.Message);
}
Output slideshow untuk konversi presentasi ke HTML
Properti baru WebConvertOptions.SlideShow (default false) mengonversi sebuah presentasi — PPT, PPTX, PPTM, PPS, PPSX, PPSM, POT, POTX, POTM, ODP, OTP atau FODP — menjadi satu file HTML yang berdiri sendiri (Html atau Htm) yang diputar sebagai slideshow. Konversi yang sudah ada tidak berubah kecuali SlideShow diatur ke true.
using (Converter converter = new Converter("presentation.pptx"))
{
WebConvertOptions options = new WebConvertOptions { SlideShow = true };
converter.Convert("slideshow.html", options);
}
Dengan SlideShow = true, opsi yang bertentangan akan melempar InvalidConvertOptionsException sebelum konversi dimulai:
| Opsi | Pesan |
|---|---|
UsePdf = true |
WebConvertOptions.SlideShow tidak dapat digabungkan dengan UsePdf: konversi melalui PDF membuang slideshow. |
Format adalah MHT atau MHTML |
WebConvertOptions.SlideShow hanya mendukung output Html dan Htm, bukan mht. (atau mhtml) |
Watermark diatur |
WebConvertOptions.SlideShow tidak mendukung watermark. |
Zoom selain 100 |
WebConvertOptions.SlideShow tidak mendukung Zoom. |
Sebuah slideshow adalah satu dokumen yang dapat dinavigasi, sehingga overload Convert halaman per halaman akan melempar System.NotSupportedException dengan pesan Saving a presentation slideshow page by page is not supported.
Tipe file baru
| Tipe | Anggota baru |
|---|---|
CompressionFileType |
Aar, Alz, Wim |
GisFileType |
GeoJsonSeq, Kmz |
| Informasi dokumen | AarDocumentInfo, AlzDocumentInfo, WimDocumentInfo — masing‑masing menampilkan ContentTree arsip |
Contoh mengonversi ZIP menjadi Apple Archive:
using (Converter converter = new Converter("assets.zip"))
{
CompressionConvertOptions options = new CompressionConvertOptions { Format = CompressionFileType.Aar };
converter.Convert("assets.aar", options);
}
Cara mendapatkan pembaruan
NuGet
Tingkatkan ke paket GroupDocs.Conversion terbaru melalui NuGet: GroupDocs.Conversion 26.9.0
dotnet add package GroupDocs.Conversion --version 26.9.0
Unduhan langsung
Unduh assembly dari halaman GroupDocs.Conversion untuk .NET 26.9