HttpServerUtility..::.MapPath Method
This page is specific to:.NET Framework Version:1.12.03.03.54.0
.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

'Usage

Dim instance As HttpServerUtility
Dim path As String
Dim returnValue As String

returnValue = instance.MapPath(path)

'Declaration

Public Function MapPath ( _
    path As String _
) As 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.

Dim FilePath As String
FilePath = 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

Community Content

No backslash in the result
Added by:LordsubD

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

Difference between 1.1 and 2.0
Added by:acureng

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.

© 2009 Microsoft Corporation. All rights reserved.   Terms of Use | Trademarks | Privacy Statement
Page view tracker
Rate the Lightweight library
x
Lightweight builds on ScriptFree (loband) by adding features you've requested: a SearchBox and default code language selection.
Do you like the SearchBox?
Do you like the tabbed code blocks?
How useful is this topic?
Tell us more.
Thanks
x
You're helping to improve MSDN Online.
Feedback
Switch View
Classic
Lightweight Beta
ScriptFree
Switch View