Path.GetPathRoot Methode

Definition

Namespace:

System.IO

Assemblys:

netstandard.dll, System.Runtime.dll

Überlädt

Name	Beschreibung
GetPathRoot(String)	Ruft die Stammverzeichnisinformationen aus dem Pfad ab, der in der angegebenen Zeichenfolge enthalten ist.
GetPathRoot(ReadOnlySpan<Char>)	Ruft die Stammverzeichnisinformationen aus dem Pfad ab, der in der angegebenen Zeichenspanne enthalten ist.

GetPathRoot(String)

Quelle:

Path.Unix.cs

Ruft die Stammverzeichnisinformationen aus dem Pfad ab, der in der angegebenen Zeichenfolge enthalten ist.

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

Parameter

path

String

Eine Zeichenfolge, die den Pfad enthält, aus dem Stammverzeichnisinformationen abgerufen werden sollen.

Gibt zurück

String

Das Stammverzeichnis, wenn path es stammet.

- oder -

Empty wenn path keine Stammverzeichnisinformationen enthalten.

- oder -

null null ist path oder effektiv leer ist.

Ausnahmen

ArgumentException

.NET Framework- und .NET Core-Versionen, die älter als 2.1 sind: path enthält mindestens ein ungültiges Zeichen, das in GetInvalidPathChars().

- oder -

.NET Framework nur: Empty wurde an path.

Beispiele

Im folgenden Beispiel wird die Verwendung der GetPathRoot Methode veranschaulicht.

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

Hinweise

Diese Methode überprüft nicht, ob der Pfad oder die Datei vorhanden ist.

Diese Methode normalisiert Verzeichnistrennzeichen.

Eine Zeichenfolge ist "effektiv leer", wenn:

• In Windows gibt truedas Aufrufen IsEmpty dieser Zeichenfolge oder alle zugehörigen Zeichen Leerzeichen (' ') zurück.
• In Unix wird durch Aufrufen IsNullOrEmpty dieser Zeichenfolge truezurückgegeben.

Mögliche Muster für die von dieser Methode zurückgegebene Zeichenfolge sind wie folgt:

• null (path war null oder eine leere Zeichenfolge).

• Eine leere Zeichenfolge (path ein relativer Pfad auf dem aktuellen Laufwerk oder Volume angegeben).

• "/" (Unix: path einen absoluten Pfad auf dem aktuellen Laufwerk angegeben).

• "X:" (Windows: path einen relativen Pfad auf einem Laufwerk angegeben, wobei X ein Laufwerk oder einen Volumebuchstaben darstellt).

• "X:\" (Windows: path einen absoluten Pfad auf einem bestimmten Laufwerk angegeben).

• "\\ComputerName\SharedFolder" (Windows: ein UNC-Pfad).

• "\\?\C:" (Windows: ein DOS-Gerätepfad, unterstützt in .NET-Versionen und in .NET Framework 4.6.2 und höher).

Weitere Informationen zu Dateipfaden unter Windows finden Sie unter Dateipfadformate auf Windows-Systemen. Eine Liste allgemeiner E/A-Aufgaben finden Sie unter "Allgemeine E/A-Aufgaben".

Weitere Informationen

• Dateiformate auf Windows-Systemen
• Datei- und Stream-E/A
• Vorgehensweise: Lesen von Text aus einer Datei
• Vorgehensweise: Schreiben von Text in eine Datei

GetPathRoot(ReadOnlySpan<Char>)

Quelle:

Path.Unix.cs

Ruft die Stammverzeichnisinformationen aus dem Pfad ab, der in der angegebenen Zeichenspanne enthalten ist.

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)

Parameter

path

ReadOnlySpan<Char>

Eine schreibgeschützte Spanne von Zeichen, die den Pfad enthalten, aus dem Stammverzeichnisinformationen abgerufen werden sollen.

Gibt zurück

ReadOnlySpan<Char>

Eine schreibgeschützte Spanne von Zeichen, die das Stammverzeichnis von path.

Hinweise

Diese Methode überprüft nicht, ob der Pfad oder die Datei vorhanden ist.

Im Gegensatz zur Zeichenfolgenüberladung normalisiert diese Methode keine Verzeichnistrennzeichen.

A ReadOnlySpan<System.Char> ist "effektiv leer", wenn:

• In Windows gibt das Aufrufen ReadOnlySpan<T>.IsEmpty dieser Zeichenspanne Leerzeichen truezurück, oder alle zugehörigen Zeichen sind Leerzeichen (' ').
• In Unix gibt das Aufrufen ReadOnlySpan<T>.IsEmpty dieser Zeichenspanne truezurück.

Mögliche Muster für die von dieser Methode zurückgegebene schreibgeschützte Zeichenspanne sind wie folgt:

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

• ReadOnlySpan<T>.Empty (path einen relativen Pfad auf dem aktuellen Laufwerk oder Volume angegeben).

• "/" (Unix: path einen absoluten Pfad auf dem aktuellen Laufwerk angegeben).

• "X:" (Windows: path einen relativen Pfad auf einem Laufwerk angegeben, wobei X ein Laufwerk oder einen Volumebuchstaben darstellt).

• "X:\" (Windows: path einen absoluten Pfad auf einem bestimmten Laufwerk angegeben).

• "\\ComputerName\SharedFolder" (Windows: ein UNC-Pfad).

• "\\?\C:" (Windows: ein DOS-Gerätepfad, unterstützt in .NET-Versionen und in .NET Framework 4.6.2 und höher).

Weitere Informationen zu Dateipfaden unter Windows finden Sie unter Dateipfadformate auf Windows-Systemen. Eine Liste allgemeiner E/A-Aufgaben finden Sie unter "Allgemeine E/A-Aufgaben".

Weitere Informationen

• Dateiformate auf Windows-Systemen