HttpServerUtility.MapPath(String) Methode

Definition

Namespace:

System.Web

Assembly:

System.Web.dll

Gibt den physischen Dateipfad zurück, der dem angegebenen virtuellen Pfad entspricht.

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

Parameter

path

String

Der virtuelle Pfad in der Webanwendung.

Gibt zurück

String

Der physische Dateipfad auf dem Webserver, der dem entspricht path.

Ausnahmen

HttpException

Die aktuelle HttpContext ist null.

-oder-

path ist ein physischer Pfad, aber ein virtueller Pfad wurde erwartet.

Beispiele

Das folgende Beispiel zeigt, wie die physische Datei eines relativen virtuellen Pfads abgerufen wird. Der Code befindet sich in der CodeBehind-Datei für eine Webseite und verwendet das Standardobjekt 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

Das nächste Beispiel ähnelt dem vorherigen Beispiel, mit der Ausnahme, wie ein physischer Pfad aus einer Klasse abgerufen wird, die sich nicht in der CodeBehind-Datei befindet.

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

Hinweise

Wenn path ja null, gibt die MapPath Methode den vollständigen physischen Pfad des Verzeichnisses zurück, das die aktuelle Anforderung für den Pfad enthält. Der relative Pfad muss keine vorhandene Datei oder einen vorhandenen Ordner angeben, damit diese Methode einen Wert zurückgibt. Sie können jedoch keinen Pfad außerhalb der Webanwendung angeben.

Important

Die MapPath Methode enthält potenziell vertrauliche Informationen über die Hostingumgebung. Der Rückgabewert sollte benutzern nicht angezeigt werden.

Eine Webanwendung, die sich befindet C:\ExampleSites\TestMapPath , gibt die folgenden Ergebnisse zurück:

Anforderung von	path	Zurückgegebener Wert
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