HttpServerUtility.MapPath(String) Methode

Definition

Gibt den physischen Dateipfad zurück, der dem angegebenen virtuellen Pfad entspricht.Returns the physical file path that corresponds to the specified virtual path.

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 zur Webanwendung.The virtual path in the Web application.

Gibt zurück

Der physische Dateipfad auf dem Webserver, der path entspricht.The physical file path on the Web server that corresponds to path.

Ausnahmen

Das aktuelle HttpContext ist null.The current HttpContext is null.

- oder --or- path ist ein physischer Pfad, es wurde aber ein virtueller Pfad erwartet.path is a physical path, but a virtual path was expected.

Beispiele

Im folgenden Beispiel wird gezeigt, wie die physische Datei eines relativen virtuellen Pfads abgerufen wird.The following example shows how to retrieve the physical file of a relative virtual path. Der Code befindet sich in der Code-Behind-Datei für eine Webseite und verwendet das Server Standard Objekt.The code resides in the code-behind file for a web page and utilizes the default Server object.

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, aber es zeigt, wie ein physischer Pfad aus einer Klasse abgerufen wird, die nicht in der Code Behind-Datei ist.The next example is similar to the previous example except it shows how to retrieve a physical path from within a class that is not in the code-behind file.

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 MapPath ist null, gibt die Methode den vollständigen physischen Pfad des Verzeichnisses zurück, das die aktuelle Anforderung für den Pfad enthält.If path is null, the MapPath method returns the full physical path of the directory that contains the current request for the path. Der relative Pfad muss keine vorhandene Datei oder einen vorhandenen Ordner angeben, damit diese Methode einen Wert zurückgibt.The relative path does not need to specify an existing file or folder for this method to return a value. Es ist jedoch nicht möglich, einen Pfad außerhalb der Webanwendung anzugeben.However, you cannot specify a path outside of the Web application.

Wichtig

Die MapPath -Methode enthält möglicherweise sensible Informationen über die Host Umgebung.The MapPath method potentially contains sensitive information about the hosting environment. Der Rückgabewert sollte Benutzern nicht angezeigt werden.The return value should not be displayed to users.

Eine Webanwendung, die C:\ExampleSites\TestMapPath sich unter befindet, würde die folgenden Ergebnisse zurückgeben:A Web application that resides at C:\ExampleSites\TestMapPath would return the following results:

Anforderung vonRequest from path Zurückgegebener WertReturned value
RootLevelPage.aspxRootLevelPage.aspx null C:\ExampleSites\TestMapPathC:\ExampleSites\TestMapPath
RootLevelPage.aspxRootLevelPage.aspx "/DownOneLevel/DownLevelPage.aspx""/DownOneLevel/DownLevelPage.aspx" C:\ExampleSites\TestMapPath\DownOneLevel\DownLevelPage.aspxC:\ExampleSites\TestMapPath\DownOneLevel\DownLevelPage.aspx
RootLevelPage.aspxRootLevelPage.aspx "/NotRealFolder""/NotRealFolder" C:\ExampleSites\TestMapPath\NotRealFolderC:\ExampleSites\TestMapPath\NotRealFolder
RootLevelPage.aspxRootLevelPage.aspx ".. /OutsideApplication""../OutsideApplication" HttpException
/DownOneLevel/DownLevelPage.aspx/DownOneLevel/DownLevelPage.aspx null C:\ExampleSites\TestMapPath\DownOneLevelC:\ExampleSites\TestMapPath\DownOneLevel
/DownOneLevel/DownLevelPage.aspx/DownOneLevel/DownLevelPage.aspx "../RootLevelPage.aspx""../RootLevelPage.aspx" C:\ExampleSites\TestMapPath\RootLevelPage.aspxC:\ExampleSites\TestMapPath\RootLevelPage.aspx

Gilt für: