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 это nullMapPath так, метод возвращает полный физический путь к каталогу, который содержит текущий запрос для пути. Относительный путь не должен указывать существующий файл или папку для этого метода для возврата значения. Однако невозможно указать путь за пределами веб-приложения.

Important

Метод 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