DocumentFormat.OpenXml과 함께 사용하는 IronWord

업데이트됨:6월 28, 2026

Translated

View the article in English

참고해 주세요이 충돌은 IronWord 2025.7.13에서 수정되었으며, 이는 현재 릴리스보다 1년 이상 앞선 버전입니다. 프로젝트가 이미 최신 IronWord 버전을 사용하고 있다면 이 문제를 겪을 가능성은 낮습니다. 아래 안내는 여전히 이전 빌드를 사용 중이거나 업그레이드 후에도 유사한 증상이 나타나는 팀을 위한 것입니다.

2025.7.13 이전의 IronWord 버전은 동일한 프로젝트에서 DocumentFormat.OpenXml와 함께 실행될 때 손상된 문서, 잘못된 서식 또는 런타임 오류를 발생시킬 수 있습니다. 이 종속성 버전 충돌은 IronWord 2025.7.13에서 수정되었습니다. 아래 안내는 프로젝트가 이전 빌드를 사용 중이거나 업그레이드 후에도 여전히 충돌이 발생하는 경우에 적용됩니다.

System.InvalidOperationException
NullReferenceException

문제는 IronWord와 DocumentFormat.OpenXml의 최신 릴리스 사이의 내부 유형 및 종속성 불일치로 인한 것입니다. 이 버전들이 일치하지 않으면, 문서 손상, 서식이 깨지거나 런타임에 예외가 발생하는 것을 볼 수 있습니다.

해결책

옵션 1: DocumentFormat.OpenXml을 2.8.1로 고정하세요

프로젝트에 두 패키지가 모두 진짜로 필요한 경우, DocumentFormat.OpenXml 버전을 2.8.1로 고정하세요. 이는 IronWord와 함께 안정적이거나 출력 문제가 없이 공존할 유일한 알려진 버전입니다.

Install-Package DocumentFormat.OpenXml -Version 2.8.1

Install-Package DocumentFormat.OpenXml -Version 2.8.1

SHELL

경고2025.7.13 이전의 IronWord 빌드에서는 더 새로운 버전의 DocumentFormat.OpenXml을 사용하면 이 충돌이 다시 발생할 수 있습니다.

옵션 2: DocumentFormat.OpenXml 포기

패키지가 작업 흐름에 필수적이지 않다면, 그것을 제거하고 IronWord만 사용하세요. IronWord만 사용하면 충돌을 완전히 피하고 출력을 신뢰할 수 있게 유지합니다.

Curtis Chau

지금 바로 엔지니어링 팀과 채팅하세요

기술 문서 작성자

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.

커티스는 개발 분야 외에도 사물 인터넷(IoT)에 깊은 관심을 가지고 있으며, 하드웨어와 소프트웨어를 통합하는 혁신적인 방법을 연구합니다. 여가 시간에는 게임을 즐기거나 디스코드 봇을 만들면서 기술에 대한 애정과 창의성을 결합합니다.

시작할 준비 되셨나요?

Nuget 다운로드 48,355 | 버전: 2026.7 방금 출시