This documentation is archived and is not being maintained.

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
)

Parameters

virtualPath
Type: System.String
The virtual path to convert to an application-relative path.

Return Value

Type: System.String
The absolute path representation of the specified virtual path.

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

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: