HttpServerUtility.MapPath(String) Metódus

Definíció

Névtér:

System.Web

Szerelvény:

System.Web.dll

A megadott virtuális elérési útnak megfelelő fizikai fájl elérési útját adja vissza.

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

Paraméterek

path

String

A webalkalmazás virtuális elérési útja.

Válaszok

String

A webkiszolgálón a fizikai fájl elérési útja, amely megfelel a következőnek path: .

Kivételek

HttpException

Az aktuális HttpContext állapot.null

-vagy-

path egy fizikai elérési út, de virtuális elérési út várt.

Példák

Az alábbi példa bemutatja, hogyan kérhető le egy relatív virtuális elérési út fizikai fájlja. A kód egy weblap kód mögötti fájljában található, és az alapértelmezett Server objektumot használja.

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

A következő példa az előző példához hasonló, de azt mutatja be, hogyan kér le egy fizikai elérési utat egy olyan osztályból, amely nem szerepel a kód mögötti fájlban.

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

Megjegyzések

Ha path igen null, a metódus annak MapPath a könyvtárnak a teljes fizikai elérési útját adja vissza, amely az elérési út aktuális kérését tartalmazza. A relatív elérési útnak nem kell megadnia egy meglévő fájlt vagy mappát ehhez a metódushoz egy érték visszaadásához. A webalkalmazáson kívül azonban nem adhat meg elérési utat.

Important

A MapPath metódus potenciálisan bizalmas információkat tartalmaz az üzemeltetési környezetről. A visszatérési érték nem jeleníthető meg a felhasználók számára.

Egy webalkalmazás, amely itt C:\ExampleSites\TestMapPath található, a következő eredményeket adja vissza:

Kérés innen:	path	Visszaadott érték
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