VirtualPathUtility.GetDirectory(String) Method

Reference

Definition

Namespace:: System.Web

Assembly:: System.Web.dll

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 the directory portion of a virtual path.

public:
 static System::String ^ GetDirectory(System::String ^ virtualPath);

public static string GetDirectory (string virtualPath);

static member GetDirectory : string -> string

Public Shared Function GetDirectory (virtualPath As String) As String

Parameters

virtualPath: String

The virtual path.

Returns

String

The directory referenced in the virtual path.

Exceptions

ArgumentException

virtualPath is not rooted.

-or-

virtualPath is null or an empty string.

Examples

The following code example demonstrates how to use the GetFileName, GetExtension, and GetDirectory methods.

StringBuilder sb = new StringBuilder();
String pathstring = Context.Request.FilePath.ToString();
sb.Append("Current file path = " + pathstring + "<br />");
sb.Append("File name = " + VirtualPathUtility.GetFileName(pathstring).ToString() + "<br />");
sb.Append("File extension = " + VirtualPathUtility.GetExtension(pathstring).ToString() + "<br />");
sb.Append("Directory = " + VirtualPathUtility.GetDirectory(pathstring).ToString() + "<br />");
Response.Write(sb.ToString());

Dim sb As New StringBuilder()
Dim pathstring As String = Context.Request.FilePath.ToString()
sb.Append("Current file path = " & pathstring & "<br />")
sb.Append("File name = " & VirtualPathUtility.GetFileName(pathstring).ToString() & "<br />")
sb.Append("File extension = " & VirtualPathUtility.GetExtension(pathstring).ToString() & "<br />")
sb.Append("Directory = " & VirtualPathUtility.GetDirectory(pathstring).ToString() & "<br />")
Response.Write(sb.ToString())

Remarks

If virtualPath is not rooted; that is, it does not equal the root operator (the tilde [~]), does not start with a tilde (~), such as a tilde and a slash mark (~/) or a tilde and a double backslash (~//), or does not start with a slash mark (/), an ArgumentException exception is thrown.

If the virtual path that is passed into the GetDirectory method is "/images/image1.gif", the returned directory is "/images".

Applies to

Jaa