VirtualPathUtility.MakeRelative(String, String) Method

Definition

Returns the relative virtual path from one virtual path containing the root operator (the tilde [~]) to another.

public:
 static System::String ^ MakeRelative(System::String ^ fromPath, System::String ^ toPath);
public static string MakeRelative (string fromPath, string toPath);
static member MakeRelative : string * string -> string
Public Shared Function MakeRelative (fromPath As String, toPath As String) As String

Parameters

fromPath
String

The starting virtual path to return the relative virtual path from.

toPath
String

The ending virtual path to return the relative virtual path to.

Returns

The relative virtual path from fromPath to toPath.

Exceptions

fromPath is not rooted.

-or-

toPath is not rooted.

Remarks

If the fromPath and toPath parameters are not rooted; that is, they do not equal the root operator (the tilde [~]), do not start with a tilde (~), such as a tilde and a slash mark (~/) or a tilde and a double backslash (~//), or do not start with a slash mark (/), an ArgumentException exception is thrown.

Query string parameters and HTML anchors that are used in the URI are not used in determining the relative path.

If fromPath is "/directory1/file1.aspx" and toPath is "/directory2/file2.aspx", the MakeRelative method returns "../directory2/file2.aspx".

Applies to

See also