VirtualPathUtility.IsAppRelative(String) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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 -> boolPublic Shared Function IsAppRelative (virtualPath As String) As BooleanParameters
- virtualPath
- String
The virtual path to check.
Returns
true if virtualPath is relative to the application; otherwise, false.
Exceptions
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.
