HttpServerUtility.MapPath(String) Metoda

Definicja

Przestrzeń nazw:

System.Web

Zestaw:

System.Web.dll

Zwraca ścieżkę pliku fizycznego odpowiadającą określonej ścieżce wirtualnej.

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

Parametry

path

String

Ścieżka wirtualna w aplikacji internetowej.

Zwraca

String

Ścieżka pliku fizycznego na serwerze sieci Web odpowiadająca .path

Wyjątki

HttpException

Bieżąca HttpContext wartość to null.

-lub- path jest ścieżką fizyczną, ale oczekiwano ścieżki wirtualnej.

Przykłady

W poniższym przykładzie pokazano, jak pobrać plik fizyczny względnej ścieżki wirtualnej. Kod znajduje się w pliku za kodem dla strony internetowej i korzysta z domyślnego Server obiektu.

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

Następny przykład jest podobny do poprzedniego przykładu, z wyjątkiem pokazano, jak pobrać ścieżkę fizyczną z klasy, która nie znajduje się w pliku za kodem.

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

Uwagi

Jeśli path jest to null, MapPath metoda zwraca pełną ścieżkę fizyczną katalogu zawierającego bieżące żądanie dla ścieżki. Ścieżka względna nie musi określać istniejącego pliku ani folderu dla tej metody w celu zwrócenia wartości. Nie można jednak określić ścieżki poza aplikacją internetową.

Ważne

Metoda MapPath potencjalnie zawiera poufne informacje o środowisku hostingu. Wartość zwracana nie powinna być wyświetlana dla użytkowników.

Aplikacja internetowa, która znajduje się w C:\ExampleSites\TestMapPath lokalizacji, zwróci następujące wyniki:

Żądanie od	path	Zwrócona wartość
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