Path.GetPathRoot Methode

  • Referenz

Definition

Namespace:
System.IO
Assembly:
System.Runtime.Extensions.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.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)

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);
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 ein ungültiges Zeichen, das in GetInvalidPathChars()definiert ist.

- 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.

Diese Methode normalisiert Verzeichnistrennzeichen.

Eine Zeichenfolge ist "effektiv leer", wenn:

  • In Windows gibt der Aufruf IsEmpty dieser Zeichenfolge zurück true, oder alle zugehörigen Zeichen sind Leerzeichen (' ').
  • Unter Unix gibt der Aufruf IsNullOrEmpty für diese 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 gibt einen absoluten Pfad auf dem aktuellen Laufwerk an).

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

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

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

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

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

Weitere Informationen

Gilt für:

GetPathRoot(ReadOnlySpan<Char>)

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.

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

  • In Windows gibt das Aufrufen ReadOnlySpan<T>.IsEmpty dieser Zeichenspanne zurück true, oder alle zugehörigen Zeichen sind Leerzeichen (' ').
  • Unter Unix gibt der Aufruf ReadOnlySpan<T>.IsEmpty für diese Zeichenspanne zurück true.

Mögliche Muster für die schreibgeschützte Zeichenspanne, die von dieser Methode zurückgegeben wird, lauten 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 gibt einen absoluten Pfad auf dem aktuellen Laufwerk an).

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

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

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

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

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

Weitere Informationen

Gilt für: