Export (0) Print
Expand All

HttpServerUtility.MapPath Method

Returns the physical file path that corresponds to the specified virtual path.

Namespace:  System.Web
Assembly:  System.Web (in System.Web.dll)

public string MapPath(
	string path
)

Parameters

path
Type: System.String

The virtual path in the Web application.

Return Value

Type: System.String
The physical file path on the Web server that corresponds to path.

ExceptionCondition
HttpException

The current HttpContext is null.

If path is null, the MapPath method returns the full physical path of the directory that contains the current request for the path. The relative path does not need to specify an existing file or folder for this method to return a value. However, you cannot specify a path outside of the Web application.

Security noteSecurity Note

The MapPath method potentially contains sensitive information about the hosting environment. The return value should not be displayed to users.

A Web application that resides at C:\ExampleSites\TestMapPath would return the following results:

Request from

path

Returned value

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

The following example shows how to retrieve the physical file of a relative virtual path. 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");
    }
}

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");
    }
}

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft