เรามีความยินดีที่จะแจ้งการเปิดตัว GroupDocs.Conversion for .NET v26.9 ซึ่งพร้อมให้ใช้งานตั้งแต่ กันยายน 2026 รุ่นนี้เพิ่มการสนับสนุนรูปแบบ GIS และการบีบอัดใหม่ ๆ ทำให้สามารถแปลงงานนำเสนอเป็นสไลด์โชว์ HTML ที่เป็นไฟล์เดียวได้ ปรับปรุงการจัดการ TIFF หลายหน้า และกำหนดขีดจำกัดการแปลง 10 ครั้งต่อกระบวนการในโหมดประเมินค่า นอกจากนี้ยังลบสมาชิก API ที่ล้าสมัยและบังคับใช้การตรวจสอบที่เข้มงวดยิ่งขึ้นสำหรับตัวเลือกที่ขัดแย้งกัน
มีอะไรใหม่ในรุ่นนี้
- [คุณลักษณะ] เพิ่ม WIM เป็นแหล่งข้อมูลสำหรับเอกสารบีบอัด (CONVERSIONNET-8488)
- [คุณลักษณะ] เพิ่ม Apple Archive (AAR) เป็นแหล่งและเป้าหมายการแปลงสำหรับเอกสารบีบอัด (CONVERSIONNET-8491)
- [คุณลักษณะ] เพิ่ม ALZ เป็นแหล่งข้อมูลสำหรับเอกสารบีบอัด (CONVERSIONNET-8494)
- [คุณลักษณะ] เพิ่ม GeoJSON Text Sequence เป็นแหล่งข้อมูลสำหรับเอกสาร GIS (CONVERSIONNET-8508)
- [คุณลักษณะ] เพิ่ม KMZ เป็นแหล่งข้อมูลสำหรับเอกสาร GIS (CONVERSIONNET-8510)
- [คุณลักษณะ] เพิ่มการสนับสนุนการแปลง GIS ให้กับเป้าหมาย .NET Framework 4.6.2 (CONVERSIONNET-8511)
- [คุณลักษณะ] เพิ่ม GML และ OSM XML เป็นเป้าหมายการแปลงสำหรับเอกสาร GIS (CONVERSIONNET-8512)
- [คุณลักษณะ] แปลงงานนำเสนอเป็นสไลด์โชว์ HTML ที่เป็นไฟล์เดียว (CONVERSIONNET-8529)
- [การปรับปรุง] ใช้ขนาดหน้าและความละเอียดของแต่ละเฟรมเมื่อต้องแปลง TIFF หลายหน้าเป็น PDF (CONVERSIONNET-8519)
- [การปรับปรุง] ใช้ขนาดหน้าและความละเอียดของเฟรมเมื่อต้องแปลง TIFF หลายหน้าแบบหน้า‑ต่อ‑หน้า (CONVERSIONNET-8520)
- [การปรับปรุง] ใช้ขนาดหน้าและความละเอียดของแต่ละเฟรมเมื่อต้องแปลง TIFF หลายหน้าเป็น PDF ที่มีแท็ก (CONVERSIONNET-8521)
- [การปรับปรุง] จำกัดโหมดประเมินค่าให้ทำการแปลงได้สูงสุด 10 ครั้งต่อกระบวนการ (CONVERSIONNET-8523)
- [การปรับปรุง] ลบตัวรับฟัง (listener) ตัวแปลงที่ล้าสมัย, ขั้นตอนตัวจัดการแบบ fluent และคุณสมบัติขนาดหน้า (CONVERSIONNET-8561)
- [ข้อบกพร่อง] PPTX → PDF: การขีดเส้นใต้สองครั้งและการขีดฆ่าสองครั้งให้ค่าพิกัด NaN บน Linux (CONVERSIONNET-8388)
- [ข้อบกพร่อง] การแปลง PDF ที่มีมากกว่า 4 หน้าในโหมดประเมินค่าล้มเหลว (CONVERSIONNET-8515)
- [ข้อบกพร่อง] ขีดจำกัดหน้าทดลองไม่ถูกนำมาใช้เมื่อแปลง PDF เป็น Web (CONVERSIONNET-8516)
- [ข้อบกพร่อง] คืนค่าจำนวนหน้าที่ถูกต้องสำหรับ TIFF หลายหน้า (CONVERSIONNET-8522)
การเปลี่ยนแปลง API สาธารณะ
การเปลี่ยนแปลงที่ทำให้โค้ดเดิมไม่ทำงานได้ (Breaking changes)
สมาชิกที่ถูกทำเครื่องหมายว่าเลิกใช้ในเวอร์ชันก่อนหน้าถูกลบออกแล้ว:
| ถูกลบ | แทนที่ด้วย |
|---|---|
IConverterListener และ ConverterSettings.Listener |
ConversionEvents OnConversionStarted / OnConversionProgress / OnConversionCompleted |
ConverterSettings.OnConversionFailed |
ConversionEvents.OnDocumentFailed |
ConverterSettings.OnConversionByPageFailed |
ConversionEvents.OnPageFailed |
ConverterSettings.OnCompressionCompleted |
ConversionEvents.OnCompressionCompleted |
Fluent .OnCompressionCompleted(...) หลังจาก .Compress(...) (IConversionCompressResultCompleted) |
FluentConverter.WithEvents(e => e.OnCompressionCompleted = ...) |
อินเทอร์เฟซแบบ fluent IConversionHandlerSetup, IConversionHandlerFailed, IConversionHandlerCompleted |
IConversionHandlersStage |
อินเทอร์เฟซแบบ fluent IConversionByPageHandlerSetup, IConversionByPageHandlerFailed, IConversionByPageHandlerCompleted |
IConversionByPageHandlersStage |
CadConvertOptions.PageSize / PageWidth / PageHeight |
CadConvertOptions.SizeSettings (PageSizeOptions) |
EBookConvertOptions.PageSize / PageWidth / PageHeight |
EBookConvertOptions.SizeSettings (PageSizeOptions) |
ใน API แบบ fluent, WithOptions(...) ตอนนี้คืนค่าเป็น IConversionHandlersStage (หรือ IConversionByPageHandlersStage สำหรับการแปลงแบบหน้า‑ต่อ‑หน้า) การเรียกต่อเนื่องเช่น .WithOptions(...).OnConversionCompleted(...).OnConversionFailed(...).Convert() ยังคงคอมไพล์ได้โดยไม่ต้องแก้ไข
ขนาดหน้าตอนนี้ตั้งค่าได้เฉพาะผ่าน SizeSettings เท่านั้น:
var options = new CadConvertOptions
{
SizeSettings = new PageSizeOptions { PageWidth = 800, PageHeight = 600 }
};
ขีดจำกัดการแปลงในโหมดประเมินค่า
หากไม่มีไลเซนส์ที่ถูกต้อง กระบวนการหนึ่งสามารถทำการแปลงได้สูงสุด 10 ครั้ง การเรียก Converter.Convert(...) ทุกครั้งจะนับเป็นการแปลงหนึ่งครั้ง — ไม่ว่าจะเป็น overload ใด ๆ, API แบบ fluent, หรือการเรียกที่ล้มเหลว — ไม่ว่าผลลัพธ์จะสร้างไฟล์กี่ไฟล์ก็ตาม Converter.GetDocumentInfo() และ Converter.IsDocumentPasswordProtected() ไม่ถูกนับ จำนวนครั้งนี้เป็นของกระบวนการที่กำลังทำงานอยู่; การรีสตาร์ทแอปพลิเคชันจะรีเซ็ตค่าใหม่ เมื่อใส่ไลเซนส์ที่ถูกต้องแล้ว การแปลงจะไม่ถูกนับหรือจำกัดอีกต่อไป
การแปลงครั้งที่ 11 จะโยนข้อยกเว้น EvaluationLimitReachedException (สืบทอดจาก GroupDocsConversionException) พร้อมข้อความ:
You are using GroupDocs.Conversion in evaluation mode: the limit of 10 documents converted per process has been reached. Get a free 30-day temporary license to remove all evaluation limits: https://purchase.groupdocs.com/temporary-license/
ให้ใส่ License หรือคีย์ Metered ก่อนการแปลงครั้งแรกเพื่อยกเลิกขีดจำกัด:
License license = new License();
license.SetLicense("GroupDocs.Conversion.lic");
using (Converter converter = new Converter("sample.docx"))
{
converter.Convert("converted.pdf", new PdfConvertOptions());
}
โค้ดที่ทำงานโดยไม่มีไลเซนส์สามารถจัดการกับขีดจำกัดได้ดังนี้:
try
{
using (Converter converter = new Converter("sample.docx"))
{
converter.Convert("converted.pdf", new PdfConvertOptions());
}
}
catch (EvaluationLimitReachedException ex)
{
Console.WriteLine(ex.Message);
}
การแปลงเป็นสไลด์โชว์สำหรับการแปลงงานนำเสนอเป็น HTML
คุณสมบัติใหม่ WebConvertOptions.SlideShow (ค่าเริ่มต้น false) จะทำการแปลงงานนำเสนอ — PPT, PPTX, PPTM, PPS, PPSX, PPSM, POT, POTX, POTM, ODP, OTP หรือ FODP — ให้เป็นไฟล์ HTML เดียวที่เป็นไฟล์ self‑contained (Html หรือ Htm) ซึ่งสามารถเล่นเป็นสไลด์โชว์ได้ การแปลงที่มีอยู่เดิมจะไม่เปลี่ยนแปลงจนกว่าจะตั้งค่า SlideShow เป็น true
using (Converter converter = new Converter("presentation.pptx"))
{
WebConvertOptions options = new WebConvertOptions { SlideShow = true };
converter.Convert("slideshow.html", options);
}
เมื่อ SlideShow = true ตัวเลือกที่ขัดแย้งกันจะโยนข้อยกเว้น InvalidConvertOptionsException ก่อนการแปลงเริ่มต้น:
| ตัวเลือก | ข้อความ |
|---|---|
UsePdf = true |
WebConvertOptions.SlideShow cannot be combined with UsePdf: converting through PDF discards the slideshow. |
Format เป็น MHT หรือ MHTML |
WebConvertOptions.SlideShow supports only Html and Htm output, not mht. (หรือ mhtml) |
Watermark ถูกตั้งค่า |
WebConvertOptions.SlideShow does not support watermarks. |
Zoom ไม่เท่ากับ 100 |
WebConvertOptions.SlideShow does not support Zoom. |
สไลด์โชว์เป็นเอกสารเดียวที่สามารถนำทางได้ ดังนั้น overload ของ Convert ที่ทำการแปลงหน้า‑ต่อ‑หน้าจะโยน System.NotSupportedException พร้อมข้อความ Saving a presentation slideshow page by page is not supported.
ประเภทไฟล์ใหม่
| ประเภท | สมาชิกใหม่ |
|---|---|
CompressionFileType |
Aar, Alz, Wim |
GisFileType |
GeoJsonSeq, Kmz |
| ข้อมูลเอกสาร | AarDocumentInfo, AlzDocumentInfo, WimDocumentInfo — แต่ละรายการเปิดเผย ContentTree ของไฟล์อาร์ไคฟ์ |
ตัวอย่างการแปลง ZIP เป็น Apple Archive:
using (Converter converter = new Converter("assets.zip"))
{
CompressionConvertOptions options = new CompressionConvertOptions { Format = CompressionFileType.Aar };
converter.Convert("assets.aar", options);
}
วิธีรับอัปเดต
NuGet
อัปเกรดแพ็กเกจ GroupDocs.Conversion เวอร์ชันล่าสุดผ่าน NuGet: GroupDocs.Conversion 26.9.0
dotnet add package GroupDocs.Conversion --version 26.9.0
ดาวน์โหลดโดยตรง
ดาวน์โหลดไฟล์ assembly จากหน้า GroupDocs.Conversion for .NET 26.9