HttpServerUtility.MapPath Method (System.Web)

MapPath Method

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

.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)

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

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

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

Reference

HttpServerUtility Class

HttpServerUtility Members

System.Web Namespace