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.

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.

.NET Framework

Supported in: 3.5, 3.0, 2.0
Show: