Path::GetExtension Method (String^)
Returns the extension of the specified path string.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- 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 |
|---|---|
| ArgumentException | 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 ''
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