GroupDocs.Conversion for .NET 26.8 – Sorotan Rilis Agustus 2026

What’s new in this release

Perubahan API Publik

⚠️ Perubahan Tidak Kompatibel ke Belakang – Pembaruan berikut mengubah perilaku publik yang ada. Sesuaikan kode Anda agar tidak terjadi kesalahan waktu jalan.

1. LoadOptions.Format kini mengembalikan null alih‑alih melempar ketika format belum diatur

Kelas yang terpengaruh: semua 28 load‑options bertipe (misalnya, SpreadsheetLoadOptions, PdfLoadOptions, CadLoadOptions, …)

Apa yang berubah
Membaca properti Format sebelum format ditetapkan sebelumnya akan memicu pengecualian. Sekarang properti tersebut mengembalikan null, memungkinkan pemeriksaan null sederhana.

Contoh migrasi

var loadOptions = new SpreadsheetLoadOptions();

if (loadOptions.Format == null)
{
    // Jalur kode baru – sebelumnya tidak dapat dijangkau karena getter melempar.
}

Panduan
Ganti semua try/catch di sekitar loadOptions.Format dengan pemeriksaan null. Jangan membandingkan dengan FileType.Unknown; tes yang benar adalah == null.

2. Validasi kecocokan tepat untuk CadLoadOptions.LayoutNames dengan pelaporan kesalahan terperinci

Kelas yang terpengaruh: CadLoadOptions

Apa yang berubah
LayoutNames kini dicocokkan tepat (case‑sensitive) dengan nama tata letak pada gambar. Jika tidak ada yang cocok, konversi gagal dengan InvalidLoadOptionsException yang mencantumkan tata letak yang tersedia serta permintaan yang tidak cocok.

Contoh migrasi

using GroupDocs.Conversion.Exceptions;

try
{
    using var converter = new Converter("drawing.dwg",
        ctx => new CadLoadOptions { LayoutNames = new[] { "layout1" } });
    converter.Convert("out.pdf", new PdfConvertOptions());
}
catch (InvalidLoadOptionsException ex)
{
    // Contoh pesan:
    // "No layout name in CadLoadOptions.LayoutNames matches this drawing, which carries
    //  Model, Layout1, Layout2. Requested: layout1. Names are matched exactly, so a name
    //  that differs only in case is a different name."
    Console.WriteLine(ex.Message);
}

Panduan

• Pastikan nama tata letak dieja dengan benar dan cocok dengan huruf besar/kecil yang ada pada gambar sumber.
• Jika hanya sebagian tata letak yang diperlukan, berikan nama yang tepat; entri yang tidak cocok diabaikan, dan tata letak yang cocok tetap dirender.

3. Gambar CAD multi‑sheet kini menghasilkan satu unit output per sheet

Kelas yang terpengaruh: Converter, PresentationConvertOptions, PdfConvertOptions

Apa yang berubah
Sebelumnya, mengonversi gambar dengan beberapa tata letak paper‑space menghasilkan satu gambar/slide yang diratakan. Sekarang konversi membuat unit output terpisah (slide, halaman, dll.) untuk setiap tata letak, dengan ukuran sesuai pengaturan halaman tata letak tersebut. Converter.GetDocumentInfo().PagesCount mencerminkan jumlah unit yang dihasilkan.

Contoh migrasi – konversi

using var converter = new Converter("multi-layout.dwg");

// Tiga sheet masuk, tiga slide keluar – sebelumnya satu slide yang diratakan.
converter.Convert("drawing.pptx", new PresentationConvertOptions());

Contoh migrasi – kueri jumlah halaman

using var converter = new Converter("multi-layout.dwg");
int sheets = converter.GetDocumentInfo().PagesCount; // Mengembalikan 3 untuk tiga tata letak

Panduan

• Sesuaikan pemrosesan selanjutnya (misalnya, pagination UI, penamaan file) untuk menangani beberapa file/halaman output.
• Untuk gambar satu‑sheet perilaku tetap sama.
• Pengecualian adalah CAD → PDF/UA‑1, yang masih menghasilkan satu halaman ber‑tag.

4. Properti baru CadLoadOptions.LayoutScope untuk mengontrol secara eksplisit ruang mana yang dikonversi

Kelas yang terpengaruh: CadLoadOptions

Apa yang berubah
LayoutScope memungkinkan Anda menentukan apakah akan memuat Model, Layouts, atau Both (default).

• Ketika LayoutNames diatur, LayoutScope diabaikan karena nama eksplisit memiliki prioritas.
• Memilih ruang yang tidak menghasilkan sheet pada gambar yang setidaknya memiliki satu sheet kini akan melempar InvalidLoadOptionsException alih‑alih secara diam‑diam merender ruang default.

Contoh migrasi – konversi hanya tata letak paper‑space

using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

using var converter = new Converter("drawing.dwg",
    ctx => new CadLoadOptions { LayoutScope = CadLayoutScope.Layouts });
converter.Convert("layouts.pdf", new PdfConvertOptions());

Panduan

• Kode yang sebelumnya mengandalkan pilihan backend implisit tetap berfungsi karena Both tetap menjadi nilai default.
• Untuk mengecualikan ruang model atau hanya menyertakannya, setel LayoutScope ke CadLayoutScope.Model atau CadLayoutScope.Layouts masing‑masing.
• Jika sebelumnya Anda mencoba memfilter tata letak dengan memberikan array LayoutNames kosong, gantilah pola itu dengan nilai LayoutScope yang sesuai untuk memperoleh kesalahan yang jelas ketika tidak ada sheet yang dipilih.

Fitur baru

Kontrol Tata Letak CAD Lanjutan: Pilih tata letak CAD tertentu, konversi setiap tata letak ke slide, lembar kerja, halaman, gambar, atau wilayah SVG masing‑masing, dan pilih ruang model, tata letak kertas, atau keduanya dengan CadLayoutScope. Ini memberikan output per‑tata letak yang tepat serta menghormati pengaturan spesifik sheet seperti orientasi dan ukuran halaman.

Dukungan Arsip yang Diperluas: Format XAR dan CAB kini tersedia sebagai sumber dan target untuk dokumen kompresi, memungkinkan konversi mulus ke dan dari tipe arsip ini.

Interoperabilitas Diagram Modern: File Mermaid MMD dapat digunakan sebagai sumber diagram, dan file Drawio didukung sebagai target konversi, memudahkan integrasi alat diagram kontemporer ke dalam alur kerja konversi Anda.

Perbaikan Stabilitas Kritis: Memperbaiki kegagalan konversi untuk EML → PDF, outline bentuk DOCX, header/footer presentasi, tautan ringkasan yang rusak, pembuatan thumbnail di Linux, serta penanganan orientasi lembar DWG. Perbaikan ini meningkatkan keandalan di seluruh alur kerja email, office, presentasi, dan CAD.

Contoh kode

using var converter = new Converter("multi-layout.dwg");

// Tiga sheet masuk, tiga slide keluar – sebelumnya satu slide yang diratakan.
converter.Convert("drawing.pptx", new PresentationConvertOptions());

Cara mendapatkan pembaruan

NuGet

Install-Package GroupDocs.Conversion -Version 26.8

GroupDocs.Conversion 26.8 on NuGet

Unduhan langsung

Tidak ada tautan unduhan langsung yang disediakan dalam catatan rilis.

Sumber daya

• SpreadsheetLoadOptions reference
• PdfLoadOptions reference
• CadLoadOptions reference
• Converter class reference
• PresentationConvertOptions reference
• PdfConvertOptions reference