Freigeben über

Path.GetPathRoot-Methode

  • Artikel

Ruft die Informationen über das Stammverzeichnis des angegebenen Pfades ab.

Namespace: System.IO
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Shared Function GetPathRoot ( _
    path As String _
) As String
'Usage
Dim path As String
Dim returnValue As String

returnValue = Path.GetPathRoot(path)

public static string GetPathRoot (
    string path
)

public:
static String^ GetPathRoot (
    String^ path
)

public static String GetPathRoot (
    String path
)

public static function GetPathRoot (
    path : String
) : String

Parameter

  • path
    Der Pfad, von dem Informationen über das Stammverzeichnis abgerufen werden sollen.

Rückgabewert

Eine Zeichenfolge, die das Stammverzeichnis von path enthält, z. B. "C:\", oder NULL (Nothing in Visual Basic), wenn pathNULL (Nothing in Visual Basic) ist, oder eine leere Zeichenfolge, wenn path keine Informationen über das Stammverzeichnis enthält.

Ausnahmen

Ausnahmetyp Bedingung

ArgumentException

path enthält mindestens eins der in InvalidPathChars definierten ungültigen Zeichen oder ein Platzhalterzeichen.

- oder -

String.Empty wurde an path übergeben.

Hinweise

In .NET Framework wird der direkte Zugriff auf physikalische Datenträger über Pfade, bei denen es sich um Gerätenamen handelt, z. B. "\\.\PHYSICALDRIVE0", nicht unterstützt.

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

Mögliche Muster für die Zeichenfolge, die von dieser Methode zurückgegeben wird, lauten wie folgt:

  • Eine leere Zeichenfolge (path gibt einen relativen Pfad für das aktuelle Laufwerk bzw. den aktuellen Datenträger an).

  • "/" (path gibt einen absoluten Pfad auf dem aktuellen Laufwerk an).

  • "X:" (path gibt einen relativen Pfad auf einem Laufwerk an, wobei X einen Laufwerk- oder Datenträgerbuchstaben darstellt).

  • "X:/" (path gibt einen absoluten Pfad auf einem angegebenen Laufwerk an).

Ein Beispiel für die Verwendung dieser Methode finden Sie im Beispielabschnitt weiter unten. In der folgenden Tabelle sind Beispiele für andere typische oder verwandte E/A-Aufgaben aufgeführt.

Aufgabe

Beispiel in diesem Thema

Erstellen einer Textdatei.

Gewusst wie: Schreiben von Text in eine Datei

Schreiben in eine Textdatei.

Gewusst wie: Schreiben von Text in eine Datei

Lesen aus einer Textdatei.

Gewusst wie: Lesen aus einer Textdatei

Abrufen einer Dateierweiterung.

GetExtension

Abrufen des voll qualifizierten Pfades einer Datei.

GetFullPath

Abrufen des Dateinamens sowie der Dateierweiterung aus einem Pfad.

GetFileName

Nur den Dateinamen aus einem Pfad abrufen.

GetFileNameWithoutExtension

Nur den Verzeichnisnamen aus einem Pfad abrufen.

GetDirectoryName

Ändern der Erweiterung einer Datei.

ChangeExtension

Bestimmen, ob eine Datei vorhanden ist.

Exists

Beispiel

Im folgenden Codebeispiel wird eine Verwendung der GetPathRoot-Methode veranschaulicht.

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

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 );

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);

var path : String = "\\mydir\\";
var fileName : String = "myfile.ext";
var fullPath : String = "C:\\mydir\\myfile.ext";
var pathRoot : String;

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);

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

Path-Klasse
Path-Member
System.IO-Namespace

Weitere Ressourcen

Datei- und Stream-E/A
Gewusst wie: Lesen aus einer Textdatei
Gewusst wie: Schreiben von Text in eine Datei