HttpRequest::MapPath Method (String^, String^, Boolean)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Maps the specified virtual path to a physical path.

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

public:
String^ MapPath(
	String^ virtualPath,
	String^ baseVirtualDir,
	bool allowCrossAppMapping
)

Parameters

virtualPath
Type: System::String^

The virtual path (absolute or relative) for the current request.

baseVirtualDir
Type: System::String^

The virtual base directory path used for relative resolution.

allowCrossAppMapping
Type: System::Boolean

true to indicate that virtualPath may belong to another application; otherwise, false.

Return Value

Type: System::String^

The physical path on the server.

Exception Condition
HttpException

allowCrossMapping is false and virtualPath belongs to another application.

HttpException

No HttpContext object is defined for the request.

System_CAPS_cautionCaution

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

.NET Framework
Available since 1.1
Return to top
Show: