เรามีความยินดีที่จะประกาศการเปิดตัว GroupDocs.Conversion for .NET v26.10 ซึ่งพร้อมให้บริการตั้งแต่ ตุลาคม 2026 รุ่นนี้มุ่งเน้นการควบคุมว่าเอกสารจะโหลดอะไรได้บ้าง: ตอนนี้โค้ดของคุณสามารถกำหนดการโหลดทรัพยากรภายนอกแต่ละรายการที่เอกสารร้องขอได้ และค่าเริ่มต้นจะปลอดภัยสำหรับเอกสารจากแหล่งที่ไม่รู้จัก นอกจากนี้ยังทำให้การแปลงเคารพรูปแบบผลลัพธ์และการเลือกหน้า ตามที่ร้องขอ แก้ไขข้อผิดพลาดการแปลงหลายรายการและปัญหาการโหลด .NET Framework และอัปเดตการพึ่งพาที่สำคัญด้านความปลอดภัย — รวมทั้งหมด 60 ฟีเจอร์ การปรับปรุง และการแก้ไขบั๊ก

จุดเด่น

กำหนดว่าเอกสารแต่ละไฟล์สามารถโหลดอะไรได้บ้าง

เอกสารมักอ้างอิงไปนอกไฟล์ของตนเอง: รูปภาพบน CDN, ไฟล์สไตล์ชีต, สคริปต์, เทกเจอร์ 3D, taxonomy ของ XBRL ในรุ่น 26.10 คุณสามารถดูคำขอแต่ละรายการและกำหนดการจัดการในโค้ดได้ โดยการทำให้คลาส IExternalResourceHandler และตั้งค่าผ่านคุณสมบัติ ExternalResourceHandler ของตัวเลือกการโหลด ตัวจัดการจะรับทรัพยากรทุกรายการพร้อมการตัดสินใจค่าเริ่มต้นที่กำหนดไว้แล้ว และสามารถอนุญาต, ข้าม หรือ — สำหรับรูปแบบส่วนใหญ่ — จัดหาข้อมูลเองได้ เช่น จากแคชของคุณเอง เพื่อให้ไม่มีการร้องขอใด ๆ เลย

ตัวจัดการนี้โหลดภาพ JPEG จากโฮสต์ที่เชื่อถือได้หนึ่งแห่งเพิ่มเติมจากสิ่งที่ค่าเริ่มต้นอนุญาต:

public class TrustedJpegHandler : IExternalResourceHandler
{
    public void OnLoading(ExternalResourceLoadingArgs args)
    {
        Uri uri;
        if (Uri.TryCreate(args.Uri, UriKind.Absolute, out uri)
            && uri.Scheme == Uri.UriSchemeHttps
            && string.Equals(uri.Host, "cdn.example.com", StringComparison.OrdinalIgnoreCase)
            && (uri.AbsolutePath.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase)
                || uri.AbsolutePath.EndsWith(".jpeg", StringComparison.OrdinalIgnoreCase)))
        {
            args.Skipped = false;
        }
    }
}
WebLoadOptions loadOptions = new WebLoadOptions
{
    ExternalResourceHandler = new TrustedJpegHandler()
};
using (Converter converter = new Converter("sample.html", (LoadContext loadContext) => loadOptions))
{
    converter.Convert("converted.pdf", new PdfConvertOptions());
}

ตัวจัดการนี้ทำงานร่วมกับตัวเลือกการโหลดสำหรับเว็บ, XML, การประมวลผลคำ, สเปรดชีต, CSV และ TSV, งานนำเสนอ, อีเมล, SVG, การเงินและเอกสาร 3D

ค่าเริ่มต้นที่ปลอดภัยสำหรับเอกสารที่ไม่เชื่อถือ

การแปลงไฟล์ที่ผู้ใช้อัปโหลดไม่ควรทำให้เซิร์ฟเวอร์ของคุณอ่านไฟล์อื่นหรือเชื่อมต่อไปยังโฮสต์ใด ๆ ก็ตาม ด้วยการตั้งค่าเริ่มต้นในรุ่น 26.10:

  • โหลดไฟล์ในเครื่องเฉพาะจากโฟลเดอร์ของเอกสารเท่านั้น และไม่โหลดจากเส้นทาง UNC;
  • ไม่รันสคริปต์ในเอกสาร HTML, MHTML, XHTML และ SVG และไม่ร้องขอไฟล์สคริปต์ใด ๆ;
  • ใช้กฎเดียวกันกับการแปลง SVG, โมเดล 3D, XBRL, XSL-FO, Markdown และการแปลงอีเมลเป็นสเปรดชีต

เมื่อเอกสารของคุณต้องการทรัพยากรภายนอกอย่างสมเหตุสมผล ให้อนุญาตตามที่เหมาะสม: ระบุตำแหน่งที่เชื่อถือได้ใน WhitelistedResources, กำหนดการจัดการต่อทรัพยากรด้วยตัวจัดการ, หรือตั้งค่า SkipExternalResources = false สำหรับเอกสารที่คุณเชื่อถือ สคริปต์จะทำงานเฉพาะเมื่อคุณตั้งค่า ExecuteScripts = true บน WebLoadOptions หรือ SvgLoadOptions เส้นทาง UNC และการอ้างอิง javascript: หรือ vbscript: จะไม่ถูกโหลดไม่ว่าการตั้งค่าเป็นอย่างไร

ผลลัพธ์ที่คุณต้องการ

การแปลงบางกรณีเคยละเลยส่วนหนึ่งของคำขอ หลายรูปแบบบังคับให้เขียนเป็น DOCX, XLSX, PPTX หรือ TIFF แบบหลายเฟรมโดยไม่คำนึงถึงรูปแบบเป้าหมายที่คุณเลือก และการเลือกหน้าถูกละเลยสำหรับอีเมล, เว็บและ TIFF หลายหน้าไปยังการประมวลผลคำ, สำหรับเอกสาร Word Flat OPC, และสำหรับ Project ไปยัง PS และ PCL ตอนนี้ทั้งหมดจะผลิตตามที่ตัวเลือกการแปลงระบุไว้ ตอนนี้วอเตอร์มาร์กก็ปรากฏเมื่อแปลงเอกสารที่ไม่ใช่รูปภาพเป็นรูปภาพ และเมื่อแปลง CSV และ TSV, หน้า MHT และ MHTML จะเรนเดอร์แทนการแสดงแหล่ง MIME ของพวกมัน อีกทั้งพื้นหลังโปร่งใสจะไม่กลายเป็นสีดำในผลลัพธ์ J2K, JP2, WMF และ WMZ

การแปลงที่ล้มเหลวน้อยลง

ไฟล์ PostScript ที่ใช้ตัวดำเนินการ run หรือ file บน .NET Framework, เอกสาร PSD, PSB และ AI ทีละหน้า, การแปลงภาพวาด CAD ทั้งหมดเป็น TeX, XHTML ที่มี SVG ฝังอยู่, PDF, XPS และ SVG ไปยัง EPUB, รวมถึง Visio และ SVG ไปยังสเปรดชีต ตอนนี้สามารถแปลงได้แทนที่จะล้มเหลว ในไฟล์อีเมล, กล่องจดหมายและไฟล์เก็บถาวร หากแนบไฟล์ที่ไม่สามารถแปลงเป็นรูปแบบเป้าหมายได้ จะไม่ทำให้การแปลงทั้งหมดล้มเหลว และเอกสารที่อยู่ภายในซึ่งไม่สามารถโหลดได้จะถูกรายงานผ่าน ConversionEvents.OnDocumentFailed

ความปลอดภัย, การให้สิทธิ์และ .NET Framework

  • System.Security.Cryptography.Pkcs ปรับเป็นเวอร์ชัน 8.0.2 (10.0.13 บน .NET 10) เพื่อแก้ไข CVE-2026-84008 และ CVE-2026-70162
  • โครงการ .NET Framework ไม่ล้มเหลวในการโหลด RuntimeInformation หรือ ValueTuple อีกต่อไป และการแปลง EML, HTML และ CAD ไม่ล้มเหลวบน .NET Framework 4.6.2 ถึง 4.7.0
  • การแปลง WebP ด้วยลิขสิทธิ์ที่ถูกต้องจะไม่แสดงแบจทดลอง ในโหมดประเมินผล ขีดจำกัด 3 หน้า จะนำไปใช้กับผลลัพธ์ SVG, SVGZ, PS และ PCL ด้วย

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

  • [Feature] เพิ่มคอลแบ็กต่อทรัพยากรเพื่อทำการตรวจสอบ, อนุญาต, ปฏิเสธ หรือจัดหาทรัพยากรภายนอกแต่ละรายการที่เอกสารโหลด
  • [Improvement] เสนอ SvgLoadOptions เป็นตัวเลือกการโหลดสำหรับเอกสาร SVG และ SVGZ
  • [Improvement] ตั้งชื่อรายการ OLM และ NSF ที่ไม่มีหัวเรื่องโดยใช้โฟลเดอร์และตำแหน่ง และหลีกเลี่ยงชื่ออุปกรณ์ Windows ที่สงวนไว้ในชื่อรายการกล่องจดหมาย
  • [Improvement] รายงานรายการ archive, email และ mailbox ที่ไม่สามารถโหลดได้ให้กับตัวจัดการ document‑failed แทนการบันทึกเพียงอย่างเดียว
  • [Bug] แบจทดลองยังคงแสดงเมื่อแปลงจาก Webp แม้จะมีลิขสิทธิ์ที่ถูกต้อง
  • [Bug] การแปลงไฟล์ VSDX เฉพาะ – ข้อความอยู่นอกขอบกล่อง
  • [Bug] ข้อความ double strikethrough ไม่คงอยู่ในการแปลง ODT ไปเป็น PDF
  • [Bug] ปัญหาการแปลง VCF ไปเป็น Excel
  • [Bug] แก้ไขการแปลงที่ล้มเหลวในการโหลด RuntimeInformation ในโครงการ .NET Framework 4.7.1+ แบบเก่าที่ใช้ PackageReference
  • [Bug] แก้ไขการแปลงที่ล้มเหลวในการโหลด RuntimeInformation หรือ ValueTuple ในโครงการ .NET Framework แบบ packages.config
  • [Bug] แก้ไขการแปลง EML, HTML และ CAD ที่ล้มเหลวบนรันไทม์ .NET Framework 4.6.2 ถึง 4.7.0
  • [Bug] การแปลง WordProcessing, Pdf และ ProjectManagement ไปยังรูปแบบสเปรดชีตใด ๆ จะสร้างเป็น XLSX เสมอ
  • [Bug] การแปลง WordProcessing, Pdf และ Diagram ไปยังรูปแบบงานนำเสนอใด ๆ จะสร้างเป็น PPTX เสมอ
  • [Bug] แก้ไขการแปลง PST, OST และ MBOX ที่ล้มเหลวเมื่อรายการไม่มีหัวเรื่องและโน้ต sticky ของ PST แปลงเป็นข้อความที่อ่านไม่ได้
  • [Bug] การแปลงเอกสารหน้าเดียวเป็นรูปแบบภาพที่ไม่ใช่ TIFF จะสร้างเป็น TIFF แบบหลายเฟรมเสมอ
  • [Bug] [GroupDocs.Conversion for .NET] อัปเดต System.Security.Cryptography.Pkcs เป็น 8.0.2 (CVE-2026-84008 / CVE-2026-70162)
  • [Bug] วอเตอร์มาร์กแบบข้อความหรือรูปภาพไม่ถูกนำไปใช้เมื่อแปลงเอกสารที่ไม่ใช่รูปภาพเป็นรูปภาพ
  • [Bug] พื้นหลังหน้าโปร่งใสกลายเป็นสีดำเมื่อแปลงเป็น J2K, JP2, WMF และ WMZ
  • [Bug] ผลลัพธ์ WMZ ของเอกสารที่สร้างจาก Word มี PNG ที่บีบอัดด้วย gzip และผลลัพธ์ EMZ ของรูปภาพบีบอัดสองครั้ง
  • [Bug] หน้า MHT และ MHTML ที่แปลงเป็นภาพแสดงแหล่ง MIME แทนหน้า
  • [Bug] ข้อมูลเอกสารของ Publisher แสดงจำนวนหน้าเป็นหนึ่งหน้าเสมอ
  • [Bug] วอเตอร์มาร์กไม่ถูกนำไปใช้เมื่อแปลง CSV และ TSV
  • [Bug] โหลดทรัพยากรภายนอกเฉพาะจากคำนำหน้า URL ที่อยู่ใน whitelist อย่างแม่นยำและจากโฟลเดอร์ของเอกสารเท่านั้น ไม่โหลดจากเส้นทาง UNC
  • [Bug] แก้ไขการแปลง CAD, Image, Diagram, DjVu, VCF และ Email ไปยัง WordProcessing ให้บันทึกเป็น DOCX สำหรับทุกเป้าหมายยกเว้น DOC
  • [Bug] แก้ไข Email ไปยัง WordProcessing ที่ละเลยการเลือกหน้าและช่วงหน้า
  • [Bug] แก้ไขการแปลง TIFF หลายหน้าไปยัง WordProcessing ที่ละเลยการเลือกหน้า
  • [Bug] เคารพ SkipExternalResources และ WhitelistedResources เมื่อแปลงเอกสาร Markdown และ CHM
  • [Bug] เคารพ SkipExternalResources และ WhitelistedResources ในการแปลง email‑to‑spreadsheet, สเปรดชีตและการแปลงตามช่วงหน้า
  • [Bug] ไม่โหลดรูปภาพจากนอกโฟลเดอร์ของเอกสารโดยค่าเริ่มต้นเมื่อแปลง HTML ไปเป็นสเปรดชีต
  • [Bug] ไม่โหลดทรัพยากรภายนอกโดยค่าเริ่มต้นเมื่อแปลง SVG ไปเป็นงานนำเสนอ, การประมวลผลคำ, สเปรดชีต, XPS หรือ EPS
  • [Bug] ไม่โหลดไลบรารีวัสดุ 3D, เทกเจอร์และบัฟเฟอร์จากนอกโฟลเดอร์โมเดลโดยค่าเริ่มต้น
  • [Bug] ไม่โหลดรูปภาพภายนอกโดยค่าเริ่มต้นเมื่อแปลง XML ผ่านสไตล์ชีต XSL‑FO
  • [Bug] แก้ไข HTML และ MHTML ไปยัง WordProcessing ให้บันทึกเป็น DOCX สำหรับทุกเป้าหมาย
  • [Bug] ไม่โหลด XBRL และ taxonomy ของ XBRL ฝังในเอกสารจากนอกโฟลเดอร์โดยค่าเริ่มต้น
  • [Bug] หยุดรันสคริปต์และดาวน์โหลดไฟล์สคริปต์เมื่อแปลงเอกสาร HTML, XHTML และ SVG
  • [Bug] แก้ไข Web ไปยัง WordProcessing ที่ละเลยการเลือกหน้าและช่วงหน้า
  • [Bug] แก้ไขเอกสาร Word Flat OPC ที่ละเลยการเลือกหน้าและช่วงหน้า
  • [Bug] ไม่ฝังเทกเจอร์จากนอกโฟลเดอร์โมเดลโดยค่าเริ่มต้นเมื่อแปลงเอกสาร 3D
  • [Bug] แก้ไขการแปลงอาร์ไคฟ์บีบอัดแบบสตรีมเดียวที่ไม่มีชื่อไฟล์
  • [Bug] แก้ไขการดึง javascript: และ vbscript: เมื่ออนุญาตให้โหลดทรัพยากรภายนอก
  • [Bug] แก้ไขเอกสาร XHTML ที่มี SVG ฝังอยู่ไม่สามารถแปลงได้
  • [Bug] แก้ไขการแปลง HTML ไปเป็น HTML ที่ล้มเหลวเมื่อไม่สามารถโหลด CSS @import แบบสัมพันธ์ได้
  • [Bug] แก้ไขการแปลง Visio และ SVG ไปยังสเปรดชีตที่ล้มเหลวบนหน้าที่ไม่มีอะไรให้วาด
  • [Bug] แก้ไขการแปลง PDF, XPS และ SVG ไปยัง EPUB ที่ล้มเหลวเมื่อมีไฮเปอร์ลิงก์ที่ไม่ครอบคลุมข้อความใด ๆ
  • [Bug] แก้ไขการแปลง email, mailbox และ archive ที่ล้มเหลวเมื่อแนบไฟล์ที่ไม่สามารถแปลงเป็นรูปแบบเป้าหมายได้
  • [Bug] แก้ไขการแปลง PCL ที่แทนที่ Courier New และฟอนต์ที่ติดตั้งอื่น ๆ หลังจากแปลง PDF
  • [Bug] GroupDocs.Conversion.LowCode 26.9.0: DOCX ไปเป็น PDF บน Linux ไม่สนใจการแทนที่ฟอนต์และใช้ฟอนต์แรกตามลำดับตัวอักษร
  • [Bug] แก้ไขข้อผิดพลาดเอกสาร XML ใน GroupDocs.Conversion.LowCode 26.9.0
  • [Bug] แก้ไขการแปลง PostScript ที่ล้มเหลวบน .NET Framework เมื่อเอกสารใช้ตัวดำเนินการ run หรือ file
  • [Bug] แก้ไขการแปลงที่ไม่มีลิขสิทธิ์ไปยังรูปแบบภาษาคำอธิบายหน้า (PDL) ที่ละเลยขีดจำกัดหน้าทดลอง
  • [Bug] แก้ไขการแปลงหน้า‑ต่อ‑หน้า ของเอกสาร PSD, PSB และ Illustrator AI ที่ล้มเหลวด้วยข้อยกเว้น
  • [Bug] แก้ไขการแปลงวิดีโอเป็นรูปแบบเสียงที่ล้มเหลวแม้จะตั้งตัวเชื่อมต่อวิดีโอแล้วก็ตาม
  • [Bug] แก้ไขการแปลง ProjectManagement ไปยัง PS และ PCL ที่สร้างหน้าพิเศษและละเลยการเลือกหน้า
  • [Bug] แก้ไข ProjectManagement ไปยัง SVG ที่เขียนเป็น UTF‑16 โดยไม่มี byte order mark
  • [Bug] แก้ไขการแปลง 3D ไปเป็น glTF และ OBJ ที่เขียนไฟล์บัฟเฟอร์และวัสดุลงในไดเรกทอรีทำงาน
  • [Bug] แก้ไขการแปลง MHT และ MHTML ไปเป็น PDF, XPS, TeX และ WordProcessing ที่แสดงแหล่ง MIME แทนหน้า
  • [Bug] แก้ไขการแปลง CAD ไปเป็น TeX ของภาพวาดทั้งหมดที่ล้มเหลวด้วย FileTypeNotSupported
  • [Bug] แก้ไขการแปลง PDL และ XML/JSON ไปเป็น PS และ PCL ที่เพิ่มหน้าพิเศษ
  • [Bug] แก้ไขการแปลง CAD ไปเป็น PS และ PCL ที่เก็บเพียงหน้าหนึ่งของภาพวาด DWF หลายหน้า
  • [Bug] แก้ไขการแปลง MBOX ที่ล้มเหลวหรือทิ้งส่วนหัวของอีเมลเมื่อหัวเรื่องของข้อความดูเหมือนชื่อไฟล์

การเปลี่ยนแปลง API สาธารณะ

API ใหม่

  • IExternalResourceHandler และ ExternalResourceLoadingArgs (Uri, Skipped, Data) ในเนมสเปซ GroupDocs.Conversion.Options.Load
  • ExternalResourceHandler บน IResourceLoadingOptions และตัวเลือกการโหลดที่ทำการใช้งาน
  • ExecuteScripts บน WebLoadOptions และ SvgLoadOptions
  • SkipExternalResources, WhitelistedResources และ ExternalResourceHandler บน FinanceLoadOptions และ ThreeDLoadOptions ซึ่งตอนนี้ทำการใช้งาน IResourceLoadingOptions

⚠️ ตรวจสอบก่อนอัปเกรด

  • ทรัพยากรภายนอก: เอกสารที่เคยพึ่งพาไฟล์ในเครื่องนอกโฟลเดอร์ของตน, เส้นทาง UNC หรือสคริปต์ ตอนนี้จะทำการแปลงโดยไม่มีสิ่งเหล่านั้น ให้อนุญาตเฉพาะสิ่งที่คุณเชื่อถือตามที่อธิบายใน ค่าเริ่มต้นที่ปลอดภัยสำหรับเอกสารที่ไม่เชื่อถือ

  • รายการ whitelist: รายการ WhitelistedResources แต่ละรายการต้องเป็นคำนำหน้า URI แบบเต็ม เช่น https://cdn.example.com/assets/ หรือ file:///C:/assets/ รายการเช่น jpg หรือ example.com ที่เวอร์ชันก่อนตรงกับ URL ใด ๆ จะทำให้การโหลดล้มเหลวด้วย InvalidLoadOptionsException

  • XBRL และ inline XBRL: การยื่นไฟล์ที่ taxonomy อยู่นอกโฟลเดอร์ของไฟล์ หรือที่โหลดจากสตรีม จะล้มเหลวด้วย InvalidLoadOptionsException ให้โหลด filing ที่คุณเชื่อถือแบบนี้:

    using (Converter converter = new Converter("filing.xbrl", (LoadContext loadContext) => new FinanceLoadOptions { SkipExternalResources = false }))
    {
        converter.Convert("filing.xlsx", new SpreadsheetConvertOptions());
    }
    
  • SVG และ SVGZ: เมื่อแปลงโดยไม่มีตัวเลือกการโหลด จะใช้ SvgLoadOptions แทน และ PossibleConversions.LoadOptions จะคืนค่า SvgLoadOptions แทน PageDescriptionLanguageLoadOptions

  • รูปแบบผลลัพธ์และหน้า: การแปลงตอนนี้เคารพรูปแบบที่ร้องขอและการเลือกหน้า ดังนั้นผลลัพธ์อาจแตกต่างจากเวอร์ชันก่อนสำหรับตัวเลือกเดียวกัน PublisherDocumentInfo.PagesCount จะคืนค่าจำนวนหน้าจริง

  • การใช้งาน IResourceLoadingOptions แบบกำหนดเอง ต้องเพิ่มคุณสมบัติ ExternalResourceHandler ใหม่

บันทึกการปล่อย release notes รายการทุกการเปลี่ยนแปลงพร้อมข้อความข้อยกเว้นที่แม่นยำ

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

NuGet

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

dotnet add package GroupDocs.Conversion --version 26.10.0

ดาวน์โหลดโดยตรง

ดาวน์โหลดแอสเซมบลีจากหน้า GroupDocs.Conversion for .NET 26.10

แหล่งข้อมูล