우리는 GroupDocs.Merger for .NET v26.10의 출시를 기쁘게 발표합니다. 이 버전은 2026년 10월부터 사용할 수 있습니다. 이번 릴리스는 외부 리소스 로딩을 제어하기 위한 주요 향상을 도입하고, EPUB 및 TeX 처리에서 중요한 동시성 문제를 해결하며, EPUB 페이지 매김을 개선하고, 자동 태깅된 출력에서 PDF 형식 및 제목을 보존하며, 여러 .NET Framework 관련 오류를 수정합니다. 전체적으로 10개의 기능, 개선 사항 및 버그 수정이 포함됩니다.
이번 릴리스의 새로운 기능
- [Feature] 외부 리소스 로딩을 기본적으로 건너뛰고, 신뢰할 수 있는 위치의 화이트리스트와 리소스별 핸들러를 사용합니다
- [Bug] 목차 파일에 .ncx 확장자가 없는 EPUB 문서에서 발생하던 NullReferenceException을 수정했습니다
- [Bug] .NET Framework packages.config 프로젝트에서 이미지 조인 시 System.ValueTuple 로드 실패를 수정했습니다
- [Bug] .NET Framework 4.6.2~4.7.0 런타임에서 SVG 문서와의 조인 실패를 수정했습니다
- [Bug] 고정 레이아웃 EPUB 페이지를 두 개로 나누는 대신 책 페이지당 하나씩 렌더링하도록 수정했습니다
- [Bug] System.Security.Cryptography.Pkcs를 8.0.2 및 9.0.21로 업데이트했습니다 (CVE-2026-84008, CVE-2026-70162)
- [Bug] 자동 태깅을 활성화한 상태로 저장할 때 원본 PDF 형식 및 제목을 유지합니다
- [Bug] TeX 문서를 동시에 로드할 때 발생하던 ArgumentException을 수정했습니다
- [Bug] Bare 파일 이름으로 지정된 LowCode 출력은 현재 디렉터리에 저장하고, 다른 형식의 결합 문서는 거부합니다
- [Bug] 동시 처리 시 EPUB 문서가 간헐적으로 NullReferenceException 또는 IndexOutOfRangeException을 발생시키는 문제를 수정했습니다
공개 API 변경 사항
1. 외부 리소스 — 기본적으로 거부 (새 API, 이전 버전과 호환되지 않음)
새로운 공개 타입이 GroupDocs.Merger.Domain.Options 네임스페이스에 추가되었습니다:
| Type | Description |
|---|---|
| IResourceLoadingOptions | SkipExternalResources, WhitelistedResources 및 ExternalResourceHandler를 정의합니다. LoadOptions가 이를 구현합니다. |
| IExternalResourceHandler | OnLoading 메서드는 각 외부 리소스가 로드되기 전에 호출되며, 허용, 건너뛰기 또는 교체할 수 있습니다. |
| ExternalResourceLoadingArgs | OnLoading에 전달되는 리소스: Uri, Skipped(다른 두 옵션의 결정에 미리 설정됨) 및 Data(리소스를 로드하는 대신 사용할 내용). |
새로운 LoadOptions 속성:
SkipExternalResources— 모든 생성자에서 기본값이true입니다.true인 동안WhitelistedResources와 일치하거나 핸들러가 허용한 리소스를 제외하고는 외부 리소스를 로드하지 않습니다.WhitelistedResources—SkipExternalResources가true인 동안 로드되는 리소스의 절대 URI 접두사이며, 예를 들어https://cdn.example.com/assets/또는file:///C:/assets/. 기본값은 비어 있습니다.ExternalResourceHandler— 기본값은null입니다.
이전 버전과 호환되지 않는 변경 사항:
- 외부 리소스는 더 이상 기본적으로 로드되지 않습니다.
http,https,ftp등 원격 리소스, UNC 경로, 로컬 파일(문서 자체 폴더의 파일 포함) 및 문서 외부를 가리키는 상대 참조는 건너뛰고 작업이 계속됩니다. 이전 버전에서는 이를 로드했습니다. 따라서 HTML, Word 및 프레젠테이션 문서의 원격 이미지와 스타일시트가 출력에 누락될 수 있으며, HTML 및 Word 문서의 페이지 수가 변경될 수 있습니다. 문서가 포함하는data:URI,cid:참조, MHTML 파트 및 패키지된 미디어는 계속 로드됩니다. 외부 리소스를 로드하려면 위치를 화이트리스트에 추가하거나, 신뢰하는 문서에 대해SkipExternalResources를false로 설정하십시오. LoadOptions가 이제sealed가 되었습니다. 이를 상속한 클래스는 더 이상 컴파일되지 않습니다.LoadOptions를 직접 사용하거나ILoadOptions를 구현하십시오;IResourceLoadingOptions를 구현하지 않은 사용자 정의ILoadOptions구현은 기본 정책을 사용합니다.WhitelistedResources항목이 null이거나 비어 있거나 절대 URI가 아니거나 쿼리 또는 프래그먼트를 포함하거나%2F,%5C,%2E를 포함하면Merger생성자가ArgumentException을 발생시킵니다 (“Whitelisted resource ‘…’ must be an absolute URI without a query, fragment or encoded ‘/’, ‘\’ or ‘.’.”).- 핸들러가 예외를 발생시키면 리소스는 건너뛰고 작업은
GroupDocsMergerException을 발생시킵니다 (“The external resource handler threw an exception; the resource was skipped. See the inner exception.”) 이때 핸들러의 예외가InnerException으로 포함됩니다. - EPUB 문서와 일부 작업의 SVG 및 SVGZ 문서는 이제 외부 참조에 대해 마크업이 검사됩니다. 마크업이 올바른 XML이 아닌 문서는
GroupDocsMergerException을 발생시킵니다 (“The document’s markup could not be read to check it for external resources, so it was not loaded. Set SkipExternalResources to false without an ExternalResourceHandler to load it without the check.”). OleDiagramOptions,OleSpreadsheetOptions,OleWordProcessingOptions생성자 중 파일 경로와 페이지 번호를 받는 경우, 대상 문서의LoadOptions와 관계없이 외부 리소스를 거부한 상태로 임베디드 객체의 이미지를 렌더링합니다. 이를 표시하려면 이미지 데이터를 직접 전달하는 생성자를 사용하십시오.GroupDocs.Merger.LowCode패키지의 제품은 항상 외부 리소스를 거부합니다.
Merger가 생성될 때 옵션이 읽히며, 그에 결합된 문서는 해당 옵션을 따릅니다.
2. 자동 태깅된 PDF 문서는 원본의 형식 및 제목을 유지
API 변경 없음. PdfSaveOptions.AccesibilitySettings.EnableAutoTagging을 true로 설정하여 저장된 PDF 문서는 PDF 형식과 원본의 제목을 유지합니다. 이전에는 모든 자동 태깅된 문서가 PDF/UA-1으로 표시되었으며, 제목이 없는 원본은 “Tagged PDF”라는 제목을 받았습니다. 자동 태깅은 논리 구조 트리를 추가하지만 문서를 PDF/UA 준수하게 만들지는 않으며, 이미 PDF/UA로 표시된 원본은 그 표시를 유지합니다.
3. 고정 레이아웃 EPUB 문서 — 책 페이지당 한 페이지
API 변경 없음. 고정 레이아웃 EPUB 문서는 이제 책 페이지당 한 페이지가 되며, 페이지 N은 책의 페이지 N과 일치합니다. 이전에는 각 책 페이지가 두 페이지로 렌더링되어 GetDocumentInfo가 페이지 수를 두 배로 보고 페이지 N이 책의 페이지 N과 맞지 않았습니다. ExtractPages, RemovePages, Split과 같은 페이지 작업에 전달되는 페이지 번호는 이제 책의 페이지를 기준으로 합니다.
4. GroupDocs.Merger.LowCode — 출력 경로 및 결합된 문서
JoinPdf,JoinDocx,JoinPptx및RemovePagesPdf는 상대 출력 경로를 현재 작업 디렉터리를 기준으로 해석합니다. 파일 이름만 지정된 출력 경로는 현재 디렉터리에 저장되며, 이전에는 Merger의 기본 출력 디렉터리에 저장되었습니다. null이거나 비어 있는 출력 경로는ArgumentNullException을 발생시킵니다.JoinPdf,JoinDocx,JoinPptx는 결합된 문서의 확장자가 제품 형식과 일치하지 않을 경우, 출력이 기록되기 전에FileTypeNotSupportedException을 발생시킵니다. 예: “Input format does not match the expected format ‘PDF’; the joined file ‘a.docx’ is ‘Microsoft Word Open XML Document (.docx)’.” 이전에는JoinPdf와JoinDocx가 혼합 출력을 생성했고JoinPptx는 나중에 다른 메시지와 함께 실패했습니다. null이거나 비어 있는 결합 문서 경로는ArgumentNullException을 발생시킵니다 (“The document at index 0 is null or empty.”).- 일곱 제품 모두 확장자가 없는 소스 경로에 대해
ArgumentException대신FileTypeNotSupportedException(“Input format does not match the expected format ‘PDF’; the supplied file is ‘Unknown’.”)을 발생시킵니다.
5. 종속성
- 런타임 패키지는 System.Security.Cryptography.Pkcs 8.0.2 (
GroupDocs.Merger.Net60,GroupDocs.Merger.Net80및 해당.Windows패키지) 또는 9.0.21 (GroupDocs.Merger.Net100및GroupDocs.Merger.Net100.Windows)에 의존합니다.GroupDocs.Merger.Net60,GroupDocs.Merger.Net60.Windows및GroupDocs.Merger.LowCode는 또한 System.Formats.Asn1 8.0.2에,GroupDocs.Merger.LowCode는 System.Security.Cryptography.Pkcs 8.0.2에 의존합니다.GroupDocs.Merger.Net462는 변경되지 않았습니다. - .NET Framework 프로젝트에서
GroupDocs.Merger패키지는 더 이상app.config또는web.config(packages.config 프로젝트)에 System.ValueTuple에 대한 바인딩 리디렉션을 추가하지 않으며, .NET Framework 빌드 대상은 프로젝트가 설정하지 않는 한DependsOnNETStandard를true로 설정합니다.
새로운 기능
- 외부 리소스 제어: 문서가 참조하는 원격 이미지, 스타일시트, 연결된 그림 및 기타 파일은 허용하지 않으면 로드되지 않습니다.
LoadOptions에 새로운SkipExternalResources,WhitelistedResources,ExternalResourceHandler속성이 추가되어 신뢰할 수 있는 위치를 허용하거나, 신뢰하는 문서에 대해 모든 것을 허용하거나, 각 리소스를 직접 결정·건너뛰기·제공할 수 있습니다. - 동시성 수정: 여러 스레드에서 처리할 때 EPUB 문서가 간헐적으로
NullReferenceException또는IndexOutOfRangeException을, TeX 문서가ArgumentException을 발생시키지 않게 수정했습니다. - EPUB 문서: 고정 레이아웃 EPUB 문서는 이제 책 페이지당 한 페이지가 되며, 페이지 N은 책의 페이지 N과 일치합니다. 목차 파일 확장자가
.ncx가 아닌 EPUB 문서는 더 이상NullReferenceException을 발생시키지 않습니다. - 자동 태깅된 PDF 출력: 자동 태깅으로 저장된 PDF 문서는 원본의 형식과 제목을 유지합니다. 원본이 PDF/UA-1이 아닌 경우 더 이상 PDF/UA-1으로 표시되지 않으며, 제목이 없는 원본은 더 이상 “Tagged PDF”라는 제목을 받지 않습니다.
- .NET Framework 프로젝트: packages.config 프로젝트에서 이미지 조인이 System.ValueTuple을 로드하지 못하는 문제가 해결되었으며, .NET Framework 4.6.2~4.7.0 런타임에서 SVG 문서와의 조인이 netstandard를 로드하지 못하는 문제가 해결되었습니다.
- 패치된 종속성: 패키지는 System.Security.Cryptography.Pkcs 8.0.2 (.NET 6.0 및 .NET 8.0) 또는 9.0.21 (.NET 10.0)에 의존하며, 이는 CVE-2026-84008 및 CVE-2026-70162를 수정한 버전입니다.
- LowCode 제품: 파일 이름만 지정된 출력 경로는 현재 디렉터리에 저장되며,
JoinPdf,JoinDocx,JoinPptx는 다른 형식의 결합 문서를 출력이 기록되기 전에 거부합니다.
코드 예제
using System.Collections.Generic;
using GroupDocs.Merger;
using GroupDocs.Merger.Domain;
using GroupDocs.Merger.Domain.Options;
var loadOptions = new LoadOptions(FileType.HTML)
{
// Load resources from one trusted folder only; everything else stays denied
WhitelistedResources = new List<string> { "https://cdn.example.com/assets/" }
};
using (var merger = new Merger("page1.html", loadOptions))
{
merger.Join("page2.html");
merger.Save("merged.html");
}
using System;
using GroupDocs.Merger.Domain.Options;
public class TrustedPngHandler : IExternalResourceHandler
{
public void OnLoading(ExternalResourceLoadingArgs args)
{
Uri uri;
if (Uri.TryCreate(args.Uri, UriKind.Absolute, out uri)
&& uri.Scheme == Uri.UriSchemeHttps
&& uri.Host == "cdn.example.com"
&& uri.AbsolutePath.EndsWith(".png", StringComparison.OrdinalIgnoreCase))
{
args.Skipped = false; // allow; any other resource keeps the default decision
}
}
}
업데이트 받는 방법
NuGet
NuGet을 통해 최신 GroupDocs.Merger 패키지로 업그레이드하십시오: GroupDocs.Merger 26.10.0
dotnet add package GroupDocs.Merger --version 26.10.0
직접 다운로드
다음 페이지에서 어셈블리를 다운로드하십시오: GroupDocs.Merger for .NET 26.10