VirtualPathUtility.GetFileName(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.

Retrieves the file name of the file that is referenced in the virtual path.

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

public static string GetFileName (string virtualPath);

static member GetFileName : string -> string

Public Shared Function GetFileName (virtualPath As String) As String

Parameters

virtualPath: String

The virtual path.

Returns

String

The file name literal after the last directory character in virtualPath; otherwise, the last directory name if the last character of virtualPath is a directory or volume separator character.

Exceptions

ArgumentException

virtualPath contains one or more characters that are not valid, as defined in InvalidPathChars.

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 the virtual path that is passed into the GetFileName method is "/images/image1.gif", the returned file name is "image1.gif".

Applies to