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.

Exception Condition
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
Available since 2.0
Return to top
Show: