Share via

Path.GetFullPath-Methode

  • Artikel

Gibt den absoluten Pfad für die angegebene Pfadzeichenfolge zurück.

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

Syntax

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

returnValue = Path.GetFullPath(path)

public static string GetFullPath (
    string path
)

public:
static String^ GetFullPath (
    String^ path
)

public static String GetFullPath (
    String path
)

public static function GetFullPath (
    path : String
) : String

Parameter

  • path
    Die Datei oder das Verzeichnis, für das die absoluten Pfadinformationen abgerufen werden sollen.

Rückgabewert

Eine Zeichenfolge, die den voll gekennzeichneten Speicherort von path enthält, z. B. "C:\MyFile.txt".

Ausnahmen

Ausnahmetyp Bedingung

ArgumentException

path ist eine Zeichenfolge der Länge 0 (null), besteht nur aus Leerraum, enthält mindestens eins der durch InvalidPathChars definierten ungültigen Zeichen oder enthält ein Platzhalterzeichen.

- oder -

Das System konnte den absoluten Pfad nicht abrufen.

SecurityException

Der Aufrufer verfügt nicht über die erforderlichen Berechtigungen.

ArgumentNullException

path ist NULL (Nothing in Visual Basic).

NotSupportedException

path enthält einen Doppelpunkt (":").

PathTooLongException

Der angegebene Pfad und/oder der Dateiname überschreiten die vom System vorgegebene Höchstlänge. Beispielsweise dürfen auf Windows-Plattformen Pfade nicht länger als 247 Zeichen und Dateinamen nicht länger als 259 Zeichen sein.

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.

Der absolute Pfad enthält alle Informationen, die zum Finden einer Datei oder eines Verzeichnisses auf einem System erforderlich sind.

Die durch path angegebene Datei bzw. das Verzeichnis muss nicht vorhanden sein. Wenn beispielsweise "c:\temp\NeuesVerz" das aktuelle Verzeichnis ist, gibt der Aufruf von GetFullPath für einen Dateinamen wie "test.txt" "c:\temp\NeuesVerz\test.txt" zurück. Die Datei muss nicht vorhanden sein.

Wenn path jedoch vorhanden ist, muss der Aufrufer über die Berechtigung verfügen, Pfadinformationen für path abzurufen. Beachten Sie, dass diese Methode im Gegensatz zu den meisten Membern der Path-Klasse auf das Dateisystem zugreift.

Diese Methode verwendet für die voll qualifizierte Kennzeichnung von path Informationen über das aktuelle Verzeichnis und Laufwerk. Wenn Sie einen Dateinamen nur in path angeben, gibt GetFullPath den voll qualifizierten Pfad des aktuellen Verzeichnisses zurück.

Wenn Sie einen kurzen Dateinamen übergeben, wird er nicht zu einem langen Dateinamen erweitert.

Wenn ein Pfad keine signifikanten Zeichen enthält, ist er ungültig, sofern er nicht mindestens ein "."-Zeichen, gefolgt von einer beliebigen Anzahl von Leerzeichen, enthält und dann entweder als "." oder ".." analysiert wird.

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

Eine Textdatei erstellen.

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

Nur den Dateinamen aus einem Pfad abrufen.

GetFileNameWithoutExtension

Nur den Verzeichnisnamen aus einem Pfad abrufen.

GetDirectoryName

Ändern der Erweiterung einer Datei.

ChangeExtension

Sortieren von Dateien in einem Verzeichnis nach Größe.

GetFileSystemInfos

Bestimmen, ob ein Verzeichnis vorhanden ist.

Exists

Bestimmen, ob eine Datei vorhanden ist.

Exists

Beispiel

Im folgenden Codebeispiel wird die GetFullPath-Methode auf einer Desktopplattform auf Grundlage von Windows veranschaulicht.

Dim fileName As string = "myfile.ext"
Dim path1 As string = "mydir"
Dim path2 As string = "\mydir"
Dim fullPath As string

fullPath = Path.GetFullPath(path1)
Console.WriteLine("GetFullPath('{0}') returns '{1}'", _
    path1, fullPath)

fullPath = Path.GetFullPath(fileName)
Console.WriteLine("GetFullPath('{0}') returns '{1}'", _
    fileName, fullPath)

fullPath = Path.GetFullPath(path2)
Console.WriteLine("GetFullPath('{0}') returns '{1}'", _
    path2, fullPath)

' Output is based on your current directory, except
' in the last case, where it is based on the root drive
' GetFullPath('mydir') returns 'C:\temp\Demo\mydir'
' GetFullPath('myfile.ext') returns 'C:\temp\Demo\myfile.ext'
' GetFullPath('\mydir') returns 'C:\mydir'

string fileName = "myfile.ext";
string path1 = @"mydir";
string path2 = @"\mydir";
string fullPath;

fullPath = Path.GetFullPath(path1);
Console.WriteLine("GetFullPath('{0}') returns '{1}'", 
    path1, fullPath);

fullPath = Path.GetFullPath(fileName);
Console.WriteLine("GetFullPath('{0}') returns '{1}'", 
    fileName, fullPath);

fullPath = Path.GetFullPath(path2);
Console.WriteLine("GetFullPath('{0}') returns '{1}'", 
    path2, fullPath);

// Output is based on your current directory, except
// in the last case, where it is based on the root drive
// GetFullPath('mydir') returns 'C:\temp\Demo\mydir'
// GetFullPath('myfile.ext') returns 'C:\temp\Demo\myfile.ext'
// GetFullPath('\mydir') returns 'C:\mydir'

String^ fileName = "myfile.ext";
String^ path = "\\mydir\\";
String^ fullPath;
fullPath = Path::GetFullPath( path );
Console::WriteLine( "GetFullPath('{0}') returns '{1}'", path, fullPath );
fullPath = Path::GetFullPath( fileName );
Console::WriteLine( "GetFullPath('{0}') returns '{1}'", fileName, fullPath );

String fileName = "myfile.ext";
String path = "\\mydir\\";
String fullPath;

fullPath = Path.GetFullPath(path);
Console.WriteLine("GetFullPath('{0}') returns '{1}'", 
    path, fullPath);

fullPath = Path.GetFullPath(fileName);
Console.WriteLine("GetFullPath('{0}') returns '{1}'", 
    fileName, fullPath);

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

fullPath = Path.GetFullPath(path);
Console.WriteLine("GetFullPath('{0}') returns '{1}'", 
                  path, fullPath);

fullPath = Path.GetFullPath(fileName);
Console.WriteLine("GetFullPath('{0}') returns '{1}'", 
                  fileName, fullPath);

.NET Framework-Sicherheit

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