우리는 GroupDocs.Conversion for .NET v26.9의 출시를 기쁘게 발표합니다. 이 버전은 2026년 9월부터 사용할 수 있습니다. 이번 릴리스는 새로운 GIS 및 압축 형식 지원을 도입하고, 프레젠테이션을 자체 포함 HTML 슬라이드쇼로 변환할 수 있게 하며, 다중 페이지 TIFF 처리 기능을 개선하고, 프로세스당 10회 변환 평가 제한을 적용합니다. 또한 오래된 API 멤버를 제거하고 충돌 옵션에 대한 검증을 강화합니다.

이번 릴리스의 새로운 기능

  • [Feature] 압축 문서의 변환 소스로 WIM 추가 (CONVERSIONNET-8488)
  • [Feature] 압축 문서의 변환 소스 및 대상에 Apple Archive (AAR) 추가 (CONVERSIONNET-8491)
  • [Feature] 압축 문서의 변환 소스로 ALZ 추가 (CONVERSIONNET-8494)
  • [Feature] GIS 문서의 변환 소스로 GeoJSON Text Sequence 추가 (CONVERSIONNET-8508)
  • [Feature] GIS 문서의 변환 소스로 KMZ 추가 (CONVERSIONNET-8510)
  • [Feature] net462 대상 프레임워크에 GIS 변환 지원 추가 (CONVERSIONNET-8511)
  • [Feature] GIS 문서의 변환 대상에 GML 및 OSM XML 추가 (CONVERSIONNET-8512)
  • [Feature] 프레젠테이션을 자체 포함 HTML 슬라이드쇼로 변환 (CONVERSIONNET-8529)
  • [Improvement] 다중 페이지 TIFF를 PDF로 변환할 때 각 프레임의 페이지 크기와 해상도를 적용 (CONVERSIONNET-8519)
  • [Improvement] 다중 페이지 TIFF를 페이지별로 변환할 때 프레임의 페이지 크기와 해상도를 적용 (CONVERSIONNET-8520)
  • [Improvement] 다중 페이지 TIFF를 태그 PDF로 변환할 때 각 프레임의 페이지 크기와 해상도를 적용 (CONVERSIONNET-8521)
  • [Improvement] 평가 모드에서 프로세스당 변환을 10회로 제한 (CONVERSIONNET-8523)
  • [Improvement] 오래된 컨버터 리스너, 플루언트 핸들러 단계 및 페이지 크기 속성 제거 (CONVERSIONNET-8561)
  • [Bug] PPTX → PDF: Linux에서 이중 밑줄 및 이중 취소선이 NaN 좌표를 발생 (CONVERSIONNET-8388)
  • [Bug] 4페이지 이상 PDF 변환이 평가 모드에서 실패 (CONVERSIONNET-8515)
  • [Bug] PDF → Web 변환 시 평가 페이지 제한이 적용되지 않음 (CONVERSIONNET-8516)
  • [Bug] 다중 페이지 TIFF의 올바른 페이지 수 반환 (CONVERSIONNET-8522)

공개 API 변경 사항

중단되는 변경 사항

이전 버전에서 폐기된 멤버가 제거되었습니다:

제거됨 대체
IConverterListener 및 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)

플루언트 API에서 WithOptions(...)는 이제 IConversionHandlersStage(또는 페이지별 변환의 경우 IConversionByPageHandlersStage)를 반환합니다. .WithOptions(...).OnConversionCompleted(...).OnConversionFailed(...).Convert()와 같은 체이닝 호출은 그대로 컴파일됩니다.

페이지 크기는 이제 SizeSettings를 통해서만 설정됩니다:

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

평가 모드 변환 제한

유효한 라이선스가 없을 경우, 하나의 프로세스에서 최대 10번의 변환만 수행할 수 있습니다. Converter.Convert(...) 호출마다 하나의 변환으로 간주되며—오버로드, 플루언트 API, 실패한 호출 모두 포함—출력 파일 수와 무관합니다. Converter.GetDocumentInfo()와 Converter.IsDocumentPasswordProtected()는 카운트되지 않습니다. 카운트는 실행 중인 프로세스에 귀속되며, 애플리케이션을 재시작하면 다시 초기화됩니다. 유효한 라이선스를 적용하면 변환 횟수가 카운트되지 않으며 제한도 사라집니다.

11번째 변환 시 EvaluationLimitReachedException (GroupDocsConversionException에서 파생) 예외가 발생하고 메시지는 다음과 같습니다:

평가 모드에서 GroupDocs.Conversion을 사용하고 있습니다: 프로세스당 변환 가능한 문서 10개 제한에 도달했습니다. 모든 평가 제한을 해제하려면 무료 30일 임시 라이선스를 받으세요: 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 파일(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.

슬라이드쇼는 하나의 탐색 가능한 문서이므로, 페이지별 Convert 오버로드는 System.NotSupportedException을 발생시키며 메시지는 Saving a presentation slideshow page by page is not supported입니다.

새로운 파일 유형

유형 새 멤버
CompressionFileType Aar, Alz, Wim
GisFileType GeoJsonSeq, Kmz
Document info 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

NuGet을 통해 최신 GroupDocs.Conversion 패키지로 업그레이드하십시오: GroupDocs.Conversion 26.9.0

dotnet add package GroupDocs.Conversion --version 26.9.0

직접 다운로드

GroupDocs.Conversion for .NET 26.9 페이지에서 어셈블리를 다운로드하십시오.

리소스