Edit

Share via

VirtualPathUtility.IsAppRelative(String) Method

  • Reference

Definition

Namespace:
System.Web
Assembly:
System.Web.dll

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

public:
 static bool IsAppRelative(System::String ^ virtualPath);
public static bool IsAppRelative (string virtualPath);
static member IsAppRelative : string -> bool
Public Shared Function IsAppRelative (virtualPath As String) As Boolean

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.

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

Dim sb2 As New StringBuilder()
Dim pathstring1 As String = 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.

Applies to

See also