Path::GetFileName Method (String^)

 

Returns the file name and extension of the specified path string.

Namespace:   System.IO
Assembly:  mscorlib (in mscorlib.dll)

public:
static String^ GetFileName(
	String^ path
)

Parameters

path
Type: System::String^

The path string from which to obtain the file name and extension.

Return Value

Type: System::String^

The characters after the last directory character in path. If the last character of path is a directory or volume separator character, this method returns String::Empty. If path is null, this method returns null.

Exception Condition
ArgumentException

path contains one or more of the invalid characters defined in GetInvalidPathChars.

The returned value is null if the file path is null.

The separator characters used to determine the start of the file name are DirectorySeparatorChar and AltDirectorySeparatorChar.

For a list of common I/O tasks, see Common I-O Tasks.

The following code example demonstrates the behavior of the GetFileName method on a Windows-based desktop platform.

String^ fileName = "C:\\mydir\\myfile.ext";
String^ path = "C:\\mydir\\";
String^ result;
result = Path::GetFileName( fileName );
Console::WriteLine( "GetFileName('{0}') returns '{1}'", fileName, result );
result = Path::GetFileName( path );
Console::WriteLine( "GetFileName('{0}') returns '{1}'", path, result );

// This code produces output similar to the following:
//
// GetFileName('C:\mydir\myfile.ext') returns 'myfile.ext'
// GetFileName('C:\mydir\') returns ''

Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
Show: