.NET Framework Class Library
HttpServerUtility..::.MapPath Method

Returns the physical file path that corresponds to the specified virtual path on the Web server.

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

Visual Basic (Declaration)
Public Function MapPath ( _
    path As String _
) As String
Visual Basic (Usage)
Dim instance As HttpServerUtility
Dim path As String
Dim returnValue As String

returnValue = instance.MapPath(path)
C#
public string MapPath(
    string path
)
Visual C++
public:
String^ MapPath(
    String^ path
)
JScript
public function MapPath(
    path : String
) : String

Parameters

path
Type: System..::.String
The virtual path of the Web server.

Return Value

Type: System..::.String
The physical file path that corresponds to path.
Exceptions

ExceptionCondition
HttpException

The current HttpContext is nullNothingnullptra null reference (Nothing in Visual Basic).

Remarks

If path is nullNothingnullptra null reference (Nothing in Visual Basic), then the MapPath method returns the full physical path of the directory that contains the current application.

Security noteSecurity Note:

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

Examples

The following example returns the physical path of the virtual directory that contains the specified Web site. In this example, the slash (/) at the beginning of the path indicates an absolute virtual path to the site.

To read MapPath in a code-behind module, use HttpContext.Current.Server.MapPath.

Visual Basic
Dim FilePath As String
FilePath = Server.MapPath("/MyWebSite")

C#
String FilePath;
FilePath = Server.MapPath("/MyWebSite");

JScript
var filePath : String = Server.MapPath("/MyWebSite")

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0
See Also

Reference

Tags :


Community Content

LordsubD
No backslash in the result

When you read the result of Server.MapPath("/MyWebSite"), note that the path does not end in a backslash as you might expect. So instead of returning
C:\Users\(username)\Documents\Visual Studio 2008\Projects\WebApplication1\WebApplication1\
you will get
C:\Users\(username)\Documents\Visual Studio 2008\Projects\WebApplication1\WebApplication1

Tags :

acureng
Difference between 1.1 and 2.0

In 1.1 and earlier the "/" is mapped to the root of the site. But in 2.0 and later the "/" is mapped to the root of the application.

Tags :

Page view tracker