GroupDocs.Conversion cho .NET 25.10 – Tháng 10 năm 2025 Điểm nổi bật của bản phát hành

Chúng tôi rất vui thông báo GroupDocs.Conversion cho .NET 25.10, có sẵn từ tháng 10 2025.
Bản phát hành phụ này mang đến một loạt các cải tiến bố cục trang, khả năng tùy chọn tải mới và một số sửa lỗi quan trọng. Thay đổi đáng chú ý nhất là việc tái cấu trúc API công khai nhóm các thiết lập lề và kích thước vào các đối tượng riêng biệt, cải thiện tính nhất quán trên tất cả các tùy chọn chuyển đổi.

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

These additions let you fine‑tune the layout of the source document before the conversion step, giving you tighter control over the appearance of the resulting files.

Tái cấu trúc API – Cài đặt Bố cục Trang (Các thay đổi gây phá vỡ)

⚠️ THAY ĐỔI GÂY PHÁ VỠ (hiệu lực v26.1) – Hai mươi thuộc tính lề/kích thước riêng lẻ đã bị loại bỏ và sẽ được xóa trong phiên bản chính tiếp theo.
Mô hình mới giới thiệu hai đối tượng trợ giúp thay thế các thuộc tính vô hướng cũ:

New helper classes

public class PageMarginOptions
{
    public float? Top { get; set; }
    public float? Bottom { get; set; }
    public float? Left { get; set; }
    public float? Right { get; set; }
}

public sealed class PageSizeOptions
{
    public PageSize PageSize { get; set; }
    public float PageWidth { get; set; }   // Setting this forces PageSize = PageSize.Custom
    public float PageHeight { get; set; }  // Setting this forces PageSize = PageSize.Custom
}

Hướng dẫn di chuyển

Di chuyển lề trang

Cách tiếp cận cũ (đã loại bỏ)

var options = new PdfConvertOptions
{
    MarginTop    = 10,
    MarginBottom = 10,
    MarginLeft   = 20,
    MarginRight  = 20
};

Cách tiếp cận mới (được khuyến nghị)

var options = new PdfConvertOptions
{
    MarginSettings = new PageMarginOptions
    {
        Top    = 10,
        Bottom = 10,
        Left   = 20,
        Right  = 20
    }
};

Di chuyển cài đặt kích thước trang

Cách tiếp cận cũ (đã loại bỏ)

// Predefined size
var pdfOptions = new PdfConvertOptions
{
    PageSize = PageSize.A4
};

// Custom dimensions
var wpOptions = new WordProcessingConvertOptions
{
    PageWidth  = 612, // points (Letter width)
    PageHeight = 792  // points (Letter height)
};

Cách tiếp cận mới (được khuyến nghị)

// Predefined size
var pdfOptions = new PdfConvertOptions
{
    SizeSettings = new PageSizeOptions
    {
        PageSize = PageSize.A4
    }
};

// Custom dimensions
var wpOptions = new WordProcessingConvertOptions
{
    SizeSettings = new PageSizeOptions
    {
        PageWidth  = 612,   // points
        PageHeight = 792    // points
        // PageSize automatically becomes PageSize.Custom
    }
};

Áp dụng các đối tượng mới loại bỏ sự mơ hồ (API trước đây trộn lẫn điểm và pixel) và đưa tất cả các tùy chọn chuyển đổi vào một mô hình chung, dễ khám phá.

Sửa lỗi và cải tiến

These fixes tighten reliability across the most common conversion scenarios and bring the library in line with expected .NET behavior.

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

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

  dotnet add package GroupDocs.Conversion --version 25.10
  

  (Cùng một gói hoạt động cho .NET 6+, .NET Framework 4.6.2 và .NET Core.)

• Tải trực tiếp – Các assembly cho cả .NET và .NET Framework có sẵn trên trang phát hành:
  https://releases.groupdocs.com/conversion/net/25-10/

Tài nguyên

• Ghi chú phát hành đầy đủ – (liên kết đến trang ghi chú phát hành chính thức, nếu có)
• Tài liệu – https://docs.groupdocs.com/conversion/net/
• Diễn đàn hỗ trợ – https://forum.groupdocs.com/c/conversion/12