Path.GetPathRoot Methode

Quelle:

Path.Unix.cs

Quelle:

Path.Unix.cs

Quelle:

Path.Unix.cs

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

Gibt zurück

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

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

Quelle:

Path.Unix.cs

Quelle:

Path.Unix.cs

Quelle:

Path.Unix.cs

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

Gibt zurück

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