We’re happy to announce GroupDocs.Conversion for .NET 25.10, available as of October 2025.
이번 마이너 릴리스는 페이지 레이아웃 개선, 새로운 로드 옵션 기능, 그리고 몇 가지 중요한 버그 수정을 제공합니다. 가장 눈에 띄는 변경 사항은 공용 API 리팩터링으로, 여백 및 크기 설정을 전용 객체로 그룹화하여 모든 변환 옵션의 일관성을 향상시킵니다.

이번 릴리스에서 새로 추가된 내용

ID 기능
CONVERSIONNET‑8032 변환 전에 EmailLoadOptions에서 페이지 크기, 여백 및 방향을 설정하도록 지원합니다.
CONVERSIONNET‑8013 변환 전에 SpreadsheetOptions에서 페이지 여백을 설정하도록 지원합니다.
CONVERSIONNET‑8012 변환 전에 SpreadsheetOptions에서 페이지 크기를 설정하도록 지원합니다.
CONVERSIONNET‑8009 변환 전에 TxtLoadOptions 및 WordProcessingLoadOptions에서 페이지 크기를 설정하도록 지원합니다.
CONVERSIONNET‑8008 변환 전에 TxtLoadOptions 및 WordProcessingLoadOptions에서 페이지 여백을 설정하도록 지원합니다.

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.
이러한 추가 기능을 통해 변환 단계 전에 원본 문서의 레이아웃을 미세 조정할 수 있어, 결과 파일의 외관을 보다 정확하게 제어할 수 있습니다.

API 리팩터링 – 페이지 레이아웃 설정 (호환성 깨짐)

⚠️ BREAKING CHANGE (v26.1 적용) – 20개의 개별 여백/크기 속성이 사용 중단 되었으며 다음 주요 버전에서 제거될 예정입니다.
새로운 모델은 기존 스칼라 속성을 대체하는 두 개의 도우미 객체를 도입합니다:

영향을받는 클래스 사용 중단된 속성 대체
PdfConvertOptions (7) MarginTop, MarginBottom, MarginLeft, MarginRight → MarginSettingsPageSize, PageWidth, PageHeight → SizeSettings MarginSettings (PageMarginOptions), SizeSettings (PageSizeOptions)
WordProcessingConvertOptions (7) Same as PDF Same as 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는 포인트와 픽셀을 혼용했습니다) 그리고 모든 변환 옵션을 공통적이고 탐색 가능한 모델에 맞추게 됩니다.

수정 및 개선 사항

ID 이슈 유형 설명
CONVERSIONNET‑8031 버그 PreserveOriginalDate가 false로 설정되어도 .NET에서 이전에 무시되었습니다.
CONVERSIONNET‑8023 버그 명시적인 변환 옵션이 제공되지 않을 때 Fluent 구문 변환이 실패했습니다.
CONVERSIONNET‑8020 버그 Microsoft.Extensions.DependencyInjection(v8.0.0.0) 누락으로 인해 WordProcessing 변환에서 처리되지 않은 예외가 발생했습니다.
CONVERSIONNET‑8006 버그 WordProcessingConvertOptions가 PageWidth/PageHeight를 포인트가 아닌 픽셀로 처리했습니다.
CONVERSIONNET‑8005 버그 PDF 변환 중 PdfConvertOptions.Margin* 속성이 적용되지 않았습니다.

These fixes tighten reliability across the most common conversion scenarios and bring the library in line with expected .NET behavior.
이러한 수정은 가장 일반적인 변환 시나리오 전반에 걸쳐 안정성을 강화하고 라이브러리를 기대되는 .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/

리소스