HttpServerUtility.MapPath(String) Methode

Definitie

Naamruimte:

System.Web

Assembly:

System.Web.dll

Retourneert het fysieke bestandspad dat overeenkomt met het opgegeven virtuele pad.

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

Parameters

path

String

Het virtuele pad in de webtoepassing.

Retouren

String

Het fysieke bestandspad op de webserver die overeenkomt met path.

Uitzonderingen

HttpException

De huidige HttpContext is null.

– of –

path is een fysiek pad, maar er werd een virtueel pad verwacht.

Voorbeelden

In het volgende voorbeeld ziet u hoe u het fysieke bestand van een relatief virtueel pad ophaalt. De code bevindt zich in het codeachter-bestand voor een webpagina en maakt gebruik van het standaardobject 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

Het volgende voorbeeld is vergelijkbaar met het vorige voorbeeld, behalve hoe u een fysiek pad ophaalt uit een klasse die zich niet in het code-behind-bestand bevindt.

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

Opmerkingen

Als path dat het is null, retourneert de MapPath methode het volledige fysieke pad van de map die de huidige aanvraag voor het pad bevat. Het relatieve pad hoeft geen bestaand bestand of bestaande map op te geven voor deze methode om een waarde te retourneren. U kunt echter geen pad opgeven buiten de webtoepassing.

Important

De MapPath methode bevat mogelijk gevoelige informatie over de hostingomgeving. De retourwaarde mag niet worden weergegeven voor gebruikers.

Een webtoepassing die zich bevindt, retourneert C:\ExampleSites\TestMapPath de volgende resultaten:

Aanvraag van	path	Geretourneerde waarde
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