Path.GetPathRoot Methode

public:
 static ReadOnlySpan<char> GetPathRoot(ReadOnlySpan<char> path);

public static ReadOnlySpan<char> GetPathRoot(ReadOnlySpan<char> path);

static member GetPathRoot : ReadOnlySpan<char> -> ReadOnlySpan<char>

Public Shared Function GetPathRoot (path As ReadOnlySpan(Of Char)) As ReadOnlySpan(Of Char)

Parameters

Retouren

Een alleen-lezen reeks tekens met de hoofdmap van path.

Opmerkingen

Met deze methode wordt niet gecontroleerd of het pad of bestand bestaat.

In tegenstelling tot de overbelasting van tekenreeksen worden met deze methode geen adreslijstscheidingstekens genormaliseerd.

A ReadOnlySpan<System.Char> is 'effectief leeg' als:

• In Windows retourneert het aanroepen van ReadOnlySpan<T>.IsEmpty voor deze reeks tekens true of zijn alle tekens spaties (' ').
• In Unix retourneert truehet aanroepen ReadOnlySpan<T>.IsEmpty van deze reeks tekens.

Mogelijke patronen voor het tekenbereik alleen-lezen dat door deze methode wordt geretourneerd, zijn als volgt:

• ReadOnlySpan<T>.Empty (path was ReadOnlySpan<T>.Empty.

• ReadOnlySpan<T>.Empty (path een relatief pad op het huidige station of volume opgegeven).

• '/' (Unix: path een absoluut pad op het huidige station opgegeven).

• "X:" (Windows: path een relatief pad op een station opgegeven, waarbij X een station of volumeletter vertegenwoordigt).

• "X:\" (Windows: path een absoluut pad op een bepaald station opgegeven).

• "\\ComputerName\SharedFolder" (Windows: een UNC-pad).

• \\?\C:" (Windows: een DOS-apparaatpad, ondersteund in .NET versies en in .NET Framework 4.6.2 en latere versies).

Zie Bestandspadindelingen op Windows systemen voor meer informatie over bestandspaden op Windows. Zie Algemene I/O-taken voor een lijst met algemene I/O-taken.

Zie ook

• Bestandspadindelingen op Windows systemen

public:
 static System::String ^ GetPathRoot(System::String ^ path);

public static string GetPathRoot(string path);

static member GetPathRoot : string -> string

Public Shared Function GetPathRoot (path As String) As String

Parameters

Retouren

De hoofdmap van path als deze is geroot.

– of –

Empty als path deze geen hoofdmapgegevens bevat.

– of –

null als path is null of in feite leeg is.

Uitzonderingen

Voorbeelden

In het volgende voorbeeld ziet u een gebruik van de GetPathRoot methode.

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:\'

Dim pathname As String = "\mydir\"
Dim fileName As String = "myfile.ext"
Dim fullPath As String = "C:\mydir\myfile.ext"
Dim pathnameRoot As String

pathnameRoot = Path.GetPathRoot(pathname)
Console.WriteLine("GetPathRoot('{0}') returns '{1}'", pathname, pathnameRoot)

pathnameRoot = Path.GetPathRoot(fileName)
Console.WriteLine("GetPathRoot('{0}') returns '{1}'", fileName, pathnameRoot)

pathnameRoot = Path.GetPathRoot(fullPath)
Console.WriteLine("GetPathRoot('{0}') returns '{1}'", fullPath, pathnameRoot)

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

Opmerkingen

Met deze methode wordt niet gecontroleerd of het pad of bestand bestaat.

Met deze methode worden adreslijstscheidingstekens genormaliseerd.

Een tekenreeks is 'effectief leeg' als:

• In Windows retourneert het aanroepen van IsEmpty op deze tekenreeks true of zijn alle tekens spaties (' ').
• In Unix retourneert truehet aanroepen van IsNullOrEmpty deze tekenreeks.

Mogelijke patronen voor de tekenreeks die door deze methode wordt geretourneerd, zijn als volgt:

• null (path was null of een lege tekenreeks).

• Een lege tekenreeks (path opgegeven een relatief pad op het huidige station of volume).

• '/' (Unix: path een absoluut pad op het huidige station opgegeven).

• "X:" (Windows: path een relatief pad op een station opgegeven, waarbij X een station of volumeletter vertegenwoordigt).

• "X:\" (Windows: path een absoluut pad op een bepaald station opgegeven).

• "\\ComputerName\SharedFolder" (Windows: een UNC-pad).

• \\?\C:" (Windows: een DOS-apparaatpad, ondersteund in .NET versies en in .NET Framework 4.6.2 en latere versies).

Zie Bestandspadindelingen op Windows systemen voor meer informatie over bestandspaden op Windows. Zie Algemene I/O-taken voor een lijst met algemene I/O-taken.

Zie ook

• Bestandspadindelingen op Windows systemen
• Bestands- en Stream-I/O
• Procedure: Tekst uit een bestand lezen
• Procedure: Tekst naar een bestand schrijven