VirtualPathUtility.ToAbsolute Method (String)

Converts a virtual path to an application absolute path.

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

public:
static String^ ToAbsolute (
	String^ virtualPath
)
public static String ToAbsolute (
	String virtualPath
)
public static function ToAbsolute (
	virtualPath : String
) : String
Not applicable.

Parameters

virtualPath

The virtual path to convert to an application-relative path.

Return Value

The absolute path representation of the specified virtual path.

Exception typeCondition

ArgumentOutOfRangeException

virtualPath is not rooted.

HttpException

A leading double period (..) is used to exit above the top directory.

An application absolute path is one where the application path is used instead of the root operator (the tilde [~]).

If virtualPath is:

  • Absolute, the ToAbsolute method returns the virtual path unchanged.

  • Application relative, the ToAbsolute method appends the current application virtual directory path to the beginning of the virtualPath. For example, the current application virtual directory path can be accessed from the AppDomainAppVirtualPath property.

  • Not rooted, the ToAbsolute method raises an ArgumentOutOfRangeException exception.

Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0

Community Additions

ADD
Show: