HttpServerUtility.MapPath(String) Metoda

Definice

Obor názvů:

System.Web

Sestavení:

System.Web.dll

Vrátí fyzickou cestu k souboru, která odpovídá zadané virtuální cestě.

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

Virtuální cesta ve webové aplikaci.

Návraty

String

Fyzická cesta k souboru na webovém serveru, který odpovídá path.

Výjimky

HttpException

HttpContext Aktuální hodnota je null.

-nebo- path je fyzická cesta, ale očekává se virtuální cesta.

Příklady

Následující příklad ukazuje, jak načíst fyzický soubor relativní virtuální cesty. Kód se nachází v souboru kódu pro webovou stránku a využívá výchozí Server objekt.

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

Další příklad je podobný předchozímu příkladu s tím rozdílem, že ukazuje, jak načíst fyzickou cestu z třídy, která není v souboru kódu.

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

Poznámky

Pokud path ano null, MapPath vrátí metoda úplnou fyzickou cestu adresáře, která obsahuje aktuální požadavek na cestu. Relativní cesta nemusí pro tuto metodu zadat existující soubor nebo složku, aby se vrátila hodnota. Nemůžete ale zadat cestu mimo webovou aplikaci.

Důležité

Tato MapPath metoda potenciálně obsahuje citlivé informace o hostitelském prostředí. Vrácená hodnota by neměla být uživatelům zobrazena.

Webová aplikace, na které se nachází, by vrátila C:\ExampleSites\TestMapPath následující výsledky:

Žádost od	path	Vrácená hodnota
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