Path::GetExtension Method (String^)


Returns the extension of the specified path string.

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

static String^ GetExtension(
	String^ path


Type: System::String^

The path string from which to get the extension.

Return Value

Type: System::String^

The extension of the specified path (including the period "."), or null, or String::Empty. If path is null, GetExtension returns null. If path does not have extension information, GetExtension returns String::Empty.

Exception Condition

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

The extension of path is obtained by searching path for a period (.), starting with the last character in path and continuing toward the start of path. If a period is found before a DirectorySeparatorChar or AltDirectorySeparatorChar character, the returned string contains the period and the characters after it; otherwise, Empty is returned.

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

The following code example demonstrates using the GetExtension method on a Windows-based desktop platform.

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

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

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