VirtualPathUtility.IsAppRelative Method (String)

 

Returns a Boolean value indicating whether the specified virtual path is relative to the application.

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

public static bool IsAppRelative(
	string virtualPath
)

Parameters

virtualPath
Type: System.String

The virtual path to check.

Return Value

Type: System.Boolean

true if virtualPath is relative to the application; otherwise, false.

Exception Condition
ArgumentNullException

virtualPath is null.

The virtual path can be just the root operator (the tilde [~]), or it can begin with the root operator. If virtualPath is null, an ArgumentNullException exception is raised. If virtualPath is an empty string (""), the IsAppRelative method returns false.

System_CAPS_noteNote

"~filename" is not a valid virtual path and returns false for the IsAppRelative method.

The following code example demonstrates how to use the IsAbsolute, IsAppRelative, and ToAppRelative methods.

StringBuilder sb2 = new StringBuilder();
String pathstring1 = Context.Request.CurrentExecutionFilePath.ToString();
sb2.Append("Current Executing File Path = " + pathstring1.ToString() + "<br />");
sb2.Append("Is Absolute = " + VirtualPathUtility.IsAbsolute(pathstring1).ToString() + "<br />");
sb2.Append("Is AppRelative = " + VirtualPathUtility.IsAppRelative(pathstring1).ToString() + "<br />");
sb2.Append("Make AppRelative = " + VirtualPathUtility.ToAppRelative(pathstring1).ToString() + "<br />");
Response.Write(sb2.ToString());

.NET Framework
Available since 2.0
Return to top
Show: