Path::GetExtension Method
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::StringThe extension of the specified path (including the period "."), or nullptr, or String::Empty. If path is nullptr, GetExtension returns nullptr. 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 ''
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.