HttpServerUtility.MapPath(String) 메서드

정의

네임스페이스:

System.Web

어셈블리:

System.Web.dll

지정된 가상 경로에 해당하는 실제 파일 경로를 반환합니다.

public:
 System::String ^ MapPath(System::String ^ path);

public string MapPath (string path);

member this.MapPath : string -> string

Public Function MapPath (path As String) As String

매개 변수

path

String

웹 애플리케이션의 가상 경로입니다.

반환

String

path에 해당하는 웹 서버의 실제 파일 경로입니다.

예외

HttpException

현재 HttpContext 가 null인 경우

또는 path은 실제 경로이지만 가상 경로가 필요합니다.

예제

다음 예제에서는 상대 가상 경로의 실제 파일을 검색하는 방법을 보여 냅니다. 코드는 웹 페이지의 코드 숨김 파일에 있으며 기본 Server 개체를 활용합니다.

public partial class _Default : Page
{
    protected void Page_Load(object sender, EventArgs e)
    {
        string pathToFiles = Server.MapPath("/UploadedFiles");
    }
}

Public Class _Default
    Inherits Page

    Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs) Handles Me.Load
        Dim pathToFiles = Server.MapPath("/UploadedFiles")
    End Sub
End Class

다음 예제는 코드 숨김 파일에 없는 클래스 내에서 실제 경로를 검색하는 방법을 보여 주는 것을 제외하고 이전 예제와 비슷합니다.

public class SampleClass
{
    public string GetFilePath()
    {
        return HttpContext.Current.Server.MapPath("/UploadedFiles");
    }
}

Public Class SampleClass
    Public Function GetFilePath() As String
        Return HttpContext.Current.Server.MapPath("/UploadedFiles")
    End Function
End Class

설명

이 경우 path 메서드는 MapPath null경로에 대한 현재 요청을 포함하는 디렉터리의 전체 실제 경로를 반환합니다. 상대 경로 값을 반환 하려면이 메서드에 대 한 기존 파일 또는 폴더를 지정할 필요가 없습니다. 그러나 웹 애플리케이션 외부에 경로 지정할 수 없습니다.

중요

이 메서드는 MapPath 호스팅 환경에 대한 중요한 정보를 포함할 수 있습니다. 반환 값은 사용자에게 표시되지 않아야 합니다.

에 있는 웹 애플리케이션을 C:\ExampleSites\TestMapPath 다음 결과가 반환 됩니다.

요청 원본	path	반환 값
RootLevelPage.aspx	null	C:\ExampleSites\TestMapPath
RootLevelPage.aspx	"/DownOneLevel/DownLevelPage.aspx"	C:\ExampleSites\TestMapPath\DownOneLevel\DownLevelPage.aspx
RootLevelPage.aspx	"/NotRealFolder"	C:\ExampleSites\TestMapPath\NotRealFolder
RootLevelPage.aspx	".. /OutsideApplication"	HttpException
/DownOneLevel/DownLevelPage.aspx	null	C:\ExampleSites\TestMapPath\DownOneLevel
/DownOneLevel/DownLevelPage.aspx	".. /RootLevelPage.aspx"	C:\ExampleSites\TestMapPath\RootLevelPage.aspx