Path.GetFullPath-Methode

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

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.

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

• FileIOPermission  für Zugriff auf den Pfad. Zugeordnete Enumeration: FileIOPermissionAccess.PathDiscovery

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