HttpServerUtility.MapPath Method (String)

.NET Framework (current version)

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

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

Syntax

member MapPath : 
        path:string -> string

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.

Exceptions

Exception	Condition
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 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

Examples

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.

No code example is currently available or this language may not be supported.

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.

No code example is currently available or this language may not be supported.

Version Information

.NET Framework
Available since 1.1