VirtualPathUtility.IsAppRelative(String) Method

Definition

Namespace:

System.Web

Assembly:

System.Web.dll

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

C#

public static bool IsAppRelative(string virtualPath);

Parameters

virtualPath

String

The virtual path to check.

Returns

Boolean

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

Exceptions

ArgumentNullException

virtualPath is null.

Examples

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

C#

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());

Remarks

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.

Note

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

See also

• IsAbsolute(String)