HttpServerUtility.MapPath(String) HttpServerUtility.MapPath(String) HttpServerUtility.MapPath(String) HttpServerUtility.MapPath(String) Method

정의

지정된 가상 경로에 해당하는 실제 파일 경로를 반환합니다.Returns the physical file path that corresponds to the specified virtual path.

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 String String

웹 애플리케이션의 가상 경로입니다.The virtual path in the Web application.

반환

path에 해당하는 웹 서버의 실제 파일 경로입니다.The physical file path on the Web server that corresponds to path.

예외

현재 HttpContextnull인 경우The current HttpContext is null.

또는-or- path은 실제 경로이지만 가상 경로가 필요합니다.path is a physical path, but a virtual path was expected.

예제

다음 예제에서는 상대 가상 경로의 실제 파일을 검색 하는 방법을 보여 줍니다.The following example shows how to retrieve the physical file of a relative virtual path. 코드를 웹 페이지에 대 한 코드 숨김 파일에 있고 기본 활용 Server 개체입니다.The code resides in the code-behind file for a web page and utilizes the default Server object.

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

다음 예제에서는 코드 숨김 파일에 없는 클래스 내에서 실제 경로 검색 하는 방법을 보여 줍니다 점을 제외 하 고 이전 예제와 비슷합니다.The next example is similar to the previous example except it shows how to retrieve a physical path from within a class that is not in the code-behind file.

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 됩니다 null, MapPath 메서드 경로 대 한 현재 요청을 포함 하는 디렉터리의 전체 실제 경로 반환 합니다.If path is null, the MapPath method returns the full physical path of the directory that contains the current request for the path. 상대 경로 기존 파일 또는 폴더 값을 반환 하려면이 메서드를 지정할 필요가 없습니다.The relative path does not need to specify an existing file or folder for this method to return a value. 그러나 웹 애플리케이션 외부에 경로 지정할 수 없습니다.However, you cannot specify a path outside of the Web application.

중요

MapPath 메서드는 호스팅 환경에 대 한 중요 한 정보를 포함 될 수 있습니다.The MapPath method potentially contains sensitive information about the hosting environment. 반환 값은 사용자에 게 표시 되지 해야 합니다.The return value should not be displayed to users.

에 있는 웹 애플리케이션을 C:\ExampleSites\TestMapPath 다음 결과가 반환 됩니다.A Web application that resides at C:\ExampleSites\TestMapPath would return the following results:

요청Request from path 반환 값Returned value
RootLevelPage.aspxRootLevelPage.aspx null C:\ExampleSites\TestMapPathC:\ExampleSites\TestMapPath
RootLevelPage.aspxRootLevelPage.aspx "/DownOneLevel/DownLevelPage.aspx""/DownOneLevel/DownLevelPage.aspx" C:\ExampleSites\TestMapPath\DownOneLevel\DownLevelPage.aspxC:\ExampleSites\TestMapPath\DownOneLevel\DownLevelPage.aspx
RootLevelPage.aspxRootLevelPage.aspx "/NotRealFolder""/NotRealFolder" C:\ExampleSites\TestMapPath\NotRealFolderC:\ExampleSites\TestMapPath\NotRealFolder
RootLevelPage.aspxRootLevelPage.aspx "../OutsideApplication""../OutsideApplication" HttpException
/DownOneLevel/DownLevelPage.aspx/DownOneLevel/DownLevelPage.aspx null C:\ExampleSites\TestMapPath\DownOneLevelC:\ExampleSites\TestMapPath\DownOneLevel
/DownOneLevel/DownLevelPage.aspx/DownOneLevel/DownLevelPage.aspx "../RootLevelPage.aspx""../RootLevelPage.aspx" C:\ExampleSites\TestMapPath\RootLevelPage.aspxC:\ExampleSites\TestMapPath\RootLevelPage.aspx

적용 대상