Path.GetPathRoot Path.GetPathRoot Path.GetPathRoot Path.GetPathRoot Method

Definition

Überlädt

GetPathRoot(ReadOnlySpan<Char>) GetPathRoot(ReadOnlySpan<Char>) GetPathRoot(ReadOnlySpan<Char>) GetPathRoot(ReadOnlySpan<Char>)

Ruft Informationen über das Stammverzeichnis aus dem Pfad ab, der in der angegebenen Zeichenspanne enthalten ist.Gets the root directory information from the path contained in the specified character span.

GetPathRoot(String) GetPathRoot(String) GetPathRoot(String) GetPathRoot(String)

Ruft die Informationen über das Stammverzeichnis des angegebenen Pfads ab.Gets the root directory information of the specified path.

GetPathRoot(ReadOnlySpan<Char>) GetPathRoot(ReadOnlySpan<Char>) GetPathRoot(ReadOnlySpan<Char>) GetPathRoot(ReadOnlySpan<Char>)

Ruft Informationen über das Stammverzeichnis aus dem Pfad ab, der in der angegebenen Zeichenspanne enthalten ist.Gets the root directory information from the path contained in the specified character span.

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>

Der Pfad, von dem Informationen über das Stammverzeichnis abgerufen werden sollen.The path from which to obtain root directory information.

Gibt zurück

Eine Zeichenspanne mit dem Stammverzeichnis von path.A character span containing the root directory of path.

Siehe auch

GetPathRoot(String) GetPathRoot(String) GetPathRoot(String) GetPathRoot(String)

Ruft die Informationen über das Stammverzeichnis des angegebenen Pfads ab.Gets the root directory information of the specified path.

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

Der Pfad, von dem Informationen über das Stammverzeichnis abgerufen werden sollen.The path from which to obtain root directory information.

Gibt zurück

Das Stammverzeichnis von path oder null, wenn path null ist, oder eine leere Zeichenfolge, wenn path keine Informationen über das Stammverzeichnis enthält.The root directory of path, or null if path is null, or an empty string if path does not contain root directory information.

Ausnahmen

path enthält mindestens eines der in GetInvalidPathChars() definierten ungültigen Zeichen.path contains one or more of the invalid characters defined in GetInvalidPathChars().

- oder --or- Empty wurde an path übergeben.Empty was passed to path.

Beispiele

Das folgende Beispiel veranschaulicht die Verwendung des der GetPathRoot Methode.The following example demonstrates a use of the GetPathRoot method.

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, dass der Pfad oder Dateiname vorhanden ist.This method does not verify that the path or file name exists.

Mögliche Muster für die Zeichenfolge, die von dieser Methode zurückgegebene lauten wie folgt aus:Possible patterns for the string returned by this method are as follows:

  • Eine leere Zeichenfolge (path gibt einen relativen Pfad auf dem aktuellen Laufwerk oder Volume).An empty string (path specified a relative path on the current drive or volume).

  • "" (path einen absoluten Pfad für das aktuelle Laufwerk angegeben)."" (path specified an absolute path on the current drive).

  • "X" (path gibt einen relativen Pfad auf einem Laufwerk, wobei X ein Laufwerk oder Volume darstellt)."X:" (path specified a relative path on a drive, where X represents a drive or volume letter).

  • "X:" (path gibt einen absoluten Pfad auf einem bestimmten Laufwerk)."X:" (path specified an absolute path on a given drive).

  • "\\ComputerName\SharedFolder" (ein UNC-Pfad)."\\ComputerName\SharedFolder" (a UNC path).

  • "\\?\C:" (eine DOS-Gerätepfad, in .NET Core 1.1 und höher und in .NET Framework 4.6.2 und höher unterstützt)"\\?\C:" (a DOS device path, supported in .NET Core 1.1 and later versions and in .NET Framework 4.6.2 and later versions)

Weitere Informationen zu Dateipfade unter Windows, finden Sie unter Pfad Dateiformate auf Windows-Systemen.For more information on file paths on Windows, see File path formats on Windows systems. Eine Liste der allgemeinen e/a-Aufgaben, finden Sie unter e/a-Aufgaben.For a list of common I/O tasks, see Common I/O Tasks.

Siehe auch

Gilt für: