Path.GetPathRoot Method
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.StringThe 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:\'
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
