Path.GetPathRoot Methode

Definition

Namespace:

System.IO

Assembly:

System.Runtime.dll

Überlädt

GetPathRoot(String)	Ruft Informationen über das Stammverzeichnis aus dem Pfad ab, der in der angegebenen Zeichenfolge enthalten ist.
GetPathRoot(ReadOnlySpan<Char>)	Ruft Informationen über das Stammverzeichnis aus dem Pfad ab, der in der angegebenen Zeichenspanne enthalten ist.

GetPathRoot(String)

Quelle:

Path.Unix.cs

Ruft Informationen über das Stammverzeichnis 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 mit dem Pfad, für den Informationen über das Stammverzeichnis abgerufen werden sollen.

Gibt zurück

String

Das Stammverzeichnis von path, wenn es einen Stamm hat.

- oder -

Empty, wenn path keine Stammverzeichnisinformationen enthält.

- oder -

null, wenn pathnull oder effektiv leer ist.

Ausnahmen

ArgumentException

.NET Framework- und .NET Core-Versionen älter als 2.1: path enthält mindestens eins der ungültigen Zeichen, die in GetInvalidPathChars()definiert sind.

- oder -

Nur .NET Framework: Empty wurde an path übergeben.

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

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.

Mit dieser Methode werden Verzeichnistrennzeichen normalisiert.

Eine Zeichenfolge ist "effektiv leer", wenn:

• In Windows gibt das Aufrufen IsEmpty dieser Zeichenfolge zurück true, oder alle zugehörigen Zeichen sind Leerzeichen (' ').
• In Unix gibt das Aufrufen IsNullOrEmpty dieser Zeichenfolge zurück true.

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 gibt einen relativen Pfad auf dem aktuellen Laufwerk oder Volume an).

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

• "X:" (Windows: path Gibt einen relativen Pfad auf einem Laufwerk an, wobei X einen Laufwerks- oder Volumebuchstaben darstellt).

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

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

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

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

• Formate von Dateipfaden unter Windows-Systemen
• Datei- und Stream-E/A
• How to: Lesen von Text aus einer Datei
• How to: Schreiben von Text in eine Datei

GetPathRoot(ReadOnlySpan<Char>)

Quelle:

Path.Unix.cs

Ruft Informationen über das Stammverzeichnis 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 enthält, für den Stammverzeichnisinformationen abgerufen werden sollen.

Gibt zurück

ReadOnlySpan<Char>

Eine schreibgeschützte Zeichenspanne mit dem 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 Spanne von Zeichen zurück true, oder alle zugehörigen Zeichen sind Leerzeichen (' ').
• In Unix gibt das Aufrufen ReadOnlySpan<T>.IsEmpty dieser Zeichenspanne zurück true.

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 Gibt einen relativen Pfad auf dem aktuellen Laufwerk oder Volume an).

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

• "X:" (Windows: path Gibt einen relativen Pfad auf einem Laufwerk an, wobei X einen Laufwerks- oder Volumebuchstaben darstellt).

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

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

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

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

• Formate von Dateipfaden unter Windows-Systemen