This documentation is archived and is not being maintained.

VirtualPathUtility.GetDirectory Method

Note: This method is new in the .NET Framework version 2.0.

Returns the directory portion of a virtual path.

Namespace: System.Web
Assembly: System.Web (in system.web.dll)

public static string GetDirectory (
	string virtualPath
public static String GetDirectory (
	String virtualPath
public static function GetDirectory (
	virtualPath : String
) : String



The virtual path.

Return Value

The directory referenced in the virtual path.

Exception typeCondition


virtualPath is not rooted.

- or -

virtualPath is a null reference (Nothing in Visual Basic) or an empty string.

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".

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

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0