Path::GetPathRoot Method (String^)
Gets the root directory information of the specified path.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- path
-
Type:
System::String^
The path from which to obtain root directory information.
Return Value
Type: System::String^The root directory of path, such as "C:\", or null if path is null, or an empty string if path does not contain root directory information.
| Exception | Condition |
|---|---|
| ArgumentException | path contains one or more of the invalid characters defined in GetInvalidPathChars. -or- String::Empty was passed to path. |
This method does not verify that the path or file name exists.
Possible patterns for the string returned by this method are as follows:
An empty string (path specified a relative path on the current drive or volume).
"/" (path specified an absolute path on the current drive).
"X:" (path specified a relative path on a drive, where X represents a drive or volume letter).
"X:/" (path specified an absolute path on a given drive).
"\\ComputerName\SharedFolder" (a UNC path).
The .NET Framework does not support direct access to physical disks through paths that are device names, such as "\\.\PHYSICALDRIVE0 ".
For a list of common I/O tasks, see Common I-O Tasks.
The following code example demonstrates a use of the GetPathRoot method.
String^ path = "\\mydir\\"; String^ fileName = "myfile.ext"; String^ fullPath = "C:\\mydir\\myfile.ext"; String^ pathRoot; pathRoot = Path::GetPathRoot( path ); Console::WriteLine( "GetPathRoot('{0}') returns '{1}'", path, pathRoot ); pathRoot = Path::GetPathRoot( fileName ); Console::WriteLine( "GetPathRoot('{0}') returns '{1}'", fileName, pathRoot ); pathRoot = Path::GetPathRoot( fullPath ); Console::WriteLine( "GetPathRoot('{0}') returns '{1}'", fullPath, pathRoot ); // This code produces output similar to the following: // // GetPathRoot('\mydir\') returns '\' // GetPathRoot('myfile.ext') returns '' // GetPathRoot('C:\mydir\myfile.ext') returns 'C:\'
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