가상 경로로 파일 저장 오류

업데이트됨:6월 28, 2026

Translated

View the article in English

ASP.NET 애플리케이션에서, PdfDocument.SaveAs()는 다음과 같은 오류와 함께 실패할 수 있습니다:

IronPDF could not write to the file '~/PDFFiles/mydocument.pdf'. It may be open in a PDF viewer.

"메시지는 잠긴 파일을 가리키지만, 실제 원인은 대개 경로에 있습니다." IronPDF는 디스크에 기록하며 완전하게 정의된 물리적 경로가 필요한 반면, ~/PDFFiles/file.pdf 같은 값은 파일 시스템이 해결할 수 없는 ASP.NET 가상 경로입니다.

가상 경로를 물리적 경로로 매핑

ASP.NET Web Forms에서 Server.MapPath()를 사용하거나 다른 곳에서 HostingEnvironment.MapPath()를 사용하여 저장하기 전에 가상 경로를 변환하십시오:

string virtualPath = "~/PDFFiles/mydocument.pdf";
string physicalPath = Server.MapPath(virtualPath); // or HostingEnvironment.MapPath outside Web Forms
pdf.SaveAs(physicalPath);

string virtualPath = "~/PDFFiles/mydocument.pdf";
string physicalPath = Server.MapPath(virtualPath); // or HostingEnvironment.MapPath outside Web Forms
pdf.SaveAs(physicalPath);

Imports System.Web

Dim virtualPath As String = "~/PDFFiles/mydocument.pdf"
Dim physicalPath As String = Server.MapPath(virtualPath) ' or HostingEnvironment.MapPath outside Web Forms
pdf.SaveAs(physicalPath)

$vbLabelText $csharpLabel

"최소한의 작동 예제:"

var renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderUrlAsPdf("https://example.com");
string physicalPath = Server.MapPath("~/App_Data/PDFFiles/output.pdf");
pdf.SaveAs(physicalPath);

var renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderUrlAsPdf("https://example.com");
string physicalPath = Server.MapPath("~/App_Data/PDFFiles/output.pdf");
pdf.SaveAs(physicalPath);

Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderUrlAsPdf("https://example.com")
Dim physicalPath As String = Server.MapPath("~/App_Data/PDFFiles/output.pdf")
pdf.SaveAs(physicalPath)

$vbLabelText $csharpLabel

저장 전 확인 사항

"- 디렉토리 존재 여부: 대상 폴더를 생성하고 앱이 해당 폴더에 쓰기 권한이 있는지 확인하십시오." "- 파일이 열려 있지 않음: 출력이 Adobe Reader와 같은 뷰어에 이미 열려 있지 않은지 확인하십시오."

제한된 위치: Program Files와 같은 보호된 폴더에 기록할 때 충분한 권한으로 실행하십시오. "- 경로 확인: 개발 중에 해결된 물리적 경로를 로그에 기록하여 예상 위치를 가리키는지 확인하십시오."

경고생산 환경에서 드라이브 문자를 하드코딩하지 마십시오; 런타임에 경로를 해결하여 애플리케이션이 여러 환경에서 작동하도록 하십시오.

Curtis Chau

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

기술 문서 작성자

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

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

시작할 준비 되셨나요?

Nuget 다운로드 20,296,129 | 버전: 2026.7 방금 출시