虛擬路徑的檔案保存錯誤

已更新:2026年6月28日

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中使用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