เรามีความยินดีที่จะประกาศ GroupDocs.Conversion for .NET 25.10 ซึ่งพร้อมให้บริการตั้งแต่ October 2025
รุ่นย่อยนี้นำเสนอชุดการปรับปรุงการจัดหน้าใหม่, ความสามารถของ load‑option ที่เพิ่มขึ้น, และการแก้ไขบั๊กสำคัญหลายรายการ การเปลี่ยนแปลงที่เห็นได้ชัดที่สุดคือ การปรับโครงสร้าง API สาธารณะ ที่จัดกลุ่มการตั้งค่าขอบและขนาดเป็นอ็อบเจกต์เฉพาะ ทำให้ความสอดคล้องทั่วทั้งตัวเลือกการแปลงดีขึ้น

มีอะไรใหม่ในรุ่นนี้

รหัส ฟีเจอร์
CONVERSIONNET‑8032 เพิ่มการสนับสนุนการตั้งค่า ขนาดหน้า, ขอบและทิศทาง ใน EmailLoadOptions ก่อนทำการแปลง
CONVERSIONNET‑8013 เพิ่มการสนับสนุนการตั้งค่า ขอบหน้า ใน SpreadsheetOptions ก่อนทำการแปลง
CONVERSIONNET‑8012 เพิ่มการสนับสนุนการตั้งค่า ขนาดหน้า ใน SpreadsheetOptions ก่อนทำการแปลง
CONVERSIONNET‑8009 เพิ่มการสนับสนุนการตั้งค่า ขนาดหน้า ใน TxtLoadOptions และ WordProcessingLoadOptions ก่อนทำการแปลง
CONVERSIONNET‑8008 เพิ่มการสนับสนุนการตั้งค่า ขอบหน้า ใน TxtLoadOptions และ WordProcessingLoadOptions ก่อนทำการแปลง

การเพิ่มเหล่านี้ทำให้คุณสามารถปรับแต่งการจัดหน้าเอกสารต้นฉบับ ก่อน ขั้นตอนการแปลงได้อย่างละเอียด ช่วยให้ควบคุมลักษณะของไฟล์ที่ได้ผลลัพธ์ได้อย่างแน่นหนายิ่งขึ้น

การปรับโครงสร้าง API – การตั้งค่าการจัดหน้า (การเปลี่ยนแปลงที่ทำให้ต้องแก้ไข)

⚠️ BREAKING CHANGE (effective v26.1) – คุณสมบัติขอบ/ขนาดแยกเป็นส่วน 20 รายการถูก เลิกใช้ และจะถูกลบออกในเวอร์ชันหลักถัดไป
โมเดลใหม่นำเสนออ็อบเจกต์ช่วยเหลือสองตัวที่แทนที่คุณสมบัติสเกลาร์แบบเก่า:

คลาสที่ได้รับผลกระทบ คุณสมบัติที่เลิกใช้ การทดแทน
PdfConvertOptions (7) MarginTop, MarginBottom, MarginLeft, MarginRight → MarginSettingsPageSize, PageWidth, PageHeight → SizeSettings MarginSettings (PageMarginOptions), SizeSettings (PageSizeOptions)
WordProcessingConvertOptions (7) เช่นเดียวกับ PDF เช่นเดียวกับ PDF
EBookConvertOptions (3) PageSize, PageWidth, PageHeight → SizeSettings SizeSettings
CadConvertOptions (3) PageSize, PageWidth, PageHeight → SizeSettings SizeSettings

คลาสช่วยเหลือใหม่

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
}

คู่มือการย้าย

การย้ายขอบหน้า

แนวทางเก่า (เลิกใช้)

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

แนวทางใหม่ (แนะนำ)

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

การย้ายการตั้งค่าขนาดหน้า

แนวทางเก่า (เลิกใช้)

// 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)
};

แนวทางใหม่ (แนะนำ)

// 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
    }
};

การใช้อ็อบเจกต์ใหม่ช่วยขจัดความกังเวช (API เวอร์ชันก่อนผสมจุดและพิกเซล) และทำให้ตัวเลือกการแปลงทั้งหมดสอดคล้องภายใต้โมเดลที่ค้นหาได้ง่ายและเป็นมาตรฐานเดียวกัน

การแก้ไขและการปรับปรุง

รหัส ประเภทปัญหา รายละเอียด
CONVERSIONNET‑8031 บั๊ก การตั้งค่า PreserveOriginalDate เป็น false ก่อนหน้านี้ถูกละเลยบน .NET
CONVERSIONNET‑8023 บั๊ก การแปลงแบบ Fluent‑syntax ล้มเหลวเมื่อไม่ได้ระบุตัวเลือกการแปลงอย่างชัดเจน
CONVERSIONNET‑8020 บั๊ก การแปลง WordProcessing ทำให้เกิดข้อยกเว้นที่ไม่ได้จัดการเนื่องจากขาด Microsoft.Extensions.DependencyInjection (v8.0.0.0)
CONVERSIONNET‑8006 บั๊ก WordProcessingConvertOptions ปฏิบัติ PageWidth/PageHeight เป็นพิกเซลแทนจุด
CONVERSIONNET‑8005 บั๊ก คุณสมบัติ PdfConvertOptions.Margin* ไม่ถูกนำไปใช้ระหว่างการแปลง PDF

การแก้ไขเหล่านี้ช่วยเพิ่มความน่าเชื่อถือในสถานการณ์การแปลงที่ใช้บ่อยที่สุดและทำให้ไลบรารีสอดคล้องกับพฤติกรรมที่คาดหวังของ .NET

วิธีรับอัปเดต

  • NuGet – อัปเกรดเป็นแพคเกจ GroupDocs.Conversion รุ่นล่าสุด:

    dotnet add package GroupDocs.Conversion --version 25.10

    (แพคเกจเดียวกันทำงานได้กับ .NET 6+, .NET Framework 4.6.2, และ .NET Core)

  • Direct download – แอสเซมบลีสำหรับ .NET และ .NET Framework พร้อมให้ดาวน์โหลดบนหน้ารีลีส:
    https://releases.groupdocs.com/conversion/net/25-10/

แหล่งข้อมูล