We’re happy to announce the release of GroupDocs.Conversion for .NET v26.9, available as of September 2026. This release introduces support for new GIS and compression formats, enables conversion of presentations to self-contained HTML slideshows, improves multi-page TIFF handling, and enforces a 10-conversion evaluation limit per process. It also removes obsolete API members and applies stricter validation for conflicting options.

Những tính năng mới trong bản phát hành này

  • [Feature] Thêm WIM làm nguồn chuyển đổi cho tài liệu nén (CONVERSIONNET-8488)
  • [Feature] Thêm Apple Archive (AAR) làm nguồn và đích chuyển đổi cho tài liệu nén (CONVERSIONNET-8491)
  • [Feature] Thêm ALZ làm nguồn chuyển đổi cho tài liệu nén (CONVERSIONNET-8494)
  • [Feature] Thêm GeoJSON Text Sequence làm nguồn chuyển đổi cho tài liệu GIS (CONVERSIONNET-8508)
  • [Feature] Thêm KMZ làm nguồn chuyển đổi cho tài liệu GIS (CONVERSIONNET-8510)
  • [Feature] Thêm hỗ trợ chuyển đổi GIS cho khung .NET target net462 (CONVERSIONNET-8511)
  • [Feature] Thêm GML và OSM XML làm đích chuyển đổi cho tài liệu GIS (CONVERSIONNET-8512)
  • [Feature] Chuyển đổi một bản trình chiếu thành slideshow HTML tự chứa (CONVERSIONNET-8529)
  • [Improvement] Áp dụng kích thước trang và độ phân giải riêng của mỗi khung khi chuyển đổi TIFF đa trang sang PDF (CONVERSIONNET-8519)
  • [Improvement] Áp dụng kích thước trang và độ phân giải riêng của khung khi chuyển đổi TIFF đa trang trang theo trang (CONVERSIONNET-8520)
  • [Improvement] Áp dụng kích thước trang và độ phân giải riêng của mỗi khung khi chuyển đổi TIFF đa trang sang PDF có thẻ (CONVERSIONNET-8521)
  • [Improvement] Giới hạn chế độ đánh giá ở 10 lần chuyển đổi mỗi tiến trình (CONVERSIONNET-8523)
  • [Improvement] Loại bỏ trình nghe converter lỗi thời, các giai đoạn xử lý fluent và các thuộc tính kích thước trang (CONVERSIONNET-8561)
  • [Bug] PPTX sang PDF: gạch chân đôi và gạch ngang đôi tạo ra tọa độ NaN trên Linux (CONVERSIONNET-8388)
  • [Bug] Chuyển đổi PDF có hơn 4 trang thất bại trong chế độ đánh giá (CONVERSIONNET-8515)
  • [Bug] Giới hạn trang dùng thử không được áp dụng khi chuyển đổi PDF sang Web (CONVERSIONNET-8516)
  • [Bug] Trả về số trang đúng cho TIFF đa trang (CONVERSIONNET-8522)

Thay đổi API công cộng

Thay đổi gây phá vỡ

Các thành viên đã được đánh dấu là lỗi thời trong các phiên bản trước đã bị loại bỏ:

Đã loại bỏ Thay thế
IConverterListener and ConverterSettings.Listener ConversionEvents OnConversionStarted / OnConversionProgress / OnConversionCompleted
ConverterSettings.OnConversionFailed ConversionEvents.OnDocumentFailed
ConverterSettings.OnConversionByPageFailed ConversionEvents.OnPageFailed
ConverterSettings.OnCompressionCompleted ConversionEvents.OnCompressionCompleted
Fluent .OnCompressionCompleted(...) after .Compress(...) (IConversionCompressResultCompleted) FluentConverter.WithEvents(e => e.OnCompressionCompleted = ...)
Fluent interfaces IConversionHandlerSetup, IConversionHandlerFailed, IConversionHandlerCompleted IConversionHandlersStage
Fluent interfaces IConversionByPageHandlerSetup, IConversionByPageHandlerFailed, IConversionByPageHandlerCompleted IConversionByPageHandlersStage
CadConvertOptions.PageSize / PageWidth / PageHeight CadConvertOptions.SizeSettings (PageSizeOptions)
EBookConvertOptions.PageSize / PageWidth / PageHeight EBookConvertOptions.SizeSettings (PageSizeOptions)

Trong API fluent, WithOptions(...) hiện trả về IConversionHandlersStage (hoặc IConversionByPageHandlersStage cho chuyển đổi trang theo trang). Các lời gọi chuỗi như .WithOptions(...).OnConversionCompleted(...).OnConversionFailed(...).Convert() vẫn biên dịch không thay đổi.

Kích thước trang hiện chỉ được đặt thông qua SizeSettings:

var options = new CadConvertOptions
{
    SizeSettings = new PageSizeOptions { PageWidth = 800, PageHeight = 600 }
};

Giới hạn chuyển đổi trong chế độ đánh giá

Không có giấy phép hợp lệ, một tiến trình tối đa chỉ có thể thực hiện 10 lần chuyển đổi. Mọi lời gọi tới Converter.Convert(...) được tính là một lần chuyển đổi — bất kỳ overload nào, API fluent, và các lời gọi thất bại — bất kể số lượng tệp đầu ra được tạo ra. Converter.GetDocumentInfo() và Converter.IsDocumentPasswordProtected() không được tính. Số đếm thuộc về tiến trình đang chạy; khởi động lại ứng dụng sẽ đặt lại. Khi giấy phép hợp lệ được áp dụng, các lần chuyển đổi không còn bị tính hoặc giới hạn.

Việc chuyển đổi thứ 11 sẽ ném ra EvaluationLimitReachedException (kế thừa từ GroupDocsConversionException) với thông báo:

Bạn đang sử dụng GroupDocs.Conversion ở chế độ đánh giá: đã đạt giới hạn 10 tài liệu được chuyển đổi mỗi tiến trình. Nhận giấy phép tạm thời miễn phí 30 ngày để loại bỏ mọi giới hạn đánh giá: https://purchase.groupdocs.com/temporary-license/

Áp dụng một License hoặc một khóa Metered trước lần chuyển đổi đầu tiên để loại bỏ giới hạn:

License license = new License();
license.SetLicense("GroupDocs.Conversion.lic");

using (Converter converter = new Converter("sample.docx"))
{
    converter.Convert("converted.pdf", new PdfConvertOptions());
}

Mã chạy mà không có giấy phép có thể xử lý giới hạn:

try
{
    using (Converter converter = new Converter("sample.docx"))
    {
        converter.Convert("converted.pdf", new PdfConvertOptions());
    }
}
catch (EvaluationLimitReachedException ex)
{
    Console.WriteLine(ex.Message);
}

Đầu ra slideshow cho chuyển đổi bản trình chiếu sang HTML

Tùy chọn mới WebConvertOptions.SlideShow (mặc định false) chuyển đổi một bản trình chiếu — PPT, PPTX, PPTM, PPS, PPSX, PPSM, POT, POTX, POTM, ODP, OTP hoặc FODP — thành một tệp HTML tự chứa duy nhất (Html hoặc Htm) phát dưới dạng slideshow. Các chuyển đổi hiện có không thay đổi trừ khi SlideShow được đặt thành true.

using (Converter converter = new Converter("presentation.pptx"))
{
    WebConvertOptions options = new WebConvertOptions { SlideShow = true };
    converter.Convert("slideshow.html", options);
}

Khi SlideShow = true, các tùy chọn mâu thuẫn sẽ ném InvalidConvertOptionsException trước khi chuyển đổi bắt đầu:

Tùy chọn Thông báo
UsePdf = true WebConvertOptions.SlideShow không thể kết hợp với UsePdf: chuyển đổi qua PDF sẽ loại bỏ slideshow.
Format is MHT or MHTML WebConvertOptions.SlideShow chỉ hỗ trợ đầu ra Html và Htm, không phải mht. (hoặc mhtml)
Watermark is set WebConvertOptions.SlideShow không hỗ trợ watermark.
Zoom other than 100 WebConvertOptions.SlideShow không hỗ trợ Zoom.

Một slideshow là một tài liệu có thể duyệt, vì vậy các overload Convert theo trang sẽ ném System.NotSupportedException với thông báo Saving a presentation slideshow page by page is not supported.

Các loại tệp mới

Loại Thành viên mới
CompressionFileType Aar, Alz, Wim
GisFileType GeoJsonSeq, Kmz
Thông tin tài liệu AarDocumentInfo, AlzDocumentInfo, WimDocumentInfo — each exposes the archive’s ContentTree

Ví dụ chuyển đổi ZIP sang Apple Archive:

using (Converter converter = new Converter("assets.zip"))
{
    CompressionConvertOptions options = new CompressionConvertOptions { Format = CompressionFileType.Aar };
    converter.Convert("assets.aar", options);
}

Cách nhận cập nhật

NuGet

Nâng cấp lên gói GroupDocs.Conversion mới nhất qua NuGet: GroupDocs.Conversion 26.9.0

dotnet add package GroupDocs.Conversion --version 26.9.0

Tải trực tiếp

Tải các assembly từ trang GroupDocs.Conversion for .NET 26.9

Tài nguyên