Path.GetFullPath Methode

public:
 static System::String ^ GetFullPath(System::String ^ path, System::String ^ basePath);

public static string GetFullPath(string path, string basePath);

static member GetFullPath : string * string -> string

Public Shared Function GetFullPath (path As String, basePath As String) As String

Parameter

Gibt zurück

Der absolute Pfad.

Ausnahmen

Beispiele

Im folgenden Beispiel wird eine Variable definiert, basePathdie das aktuelle Verzeichnis einer Anwendung darstellt. Anschließend wird sie an die GetFullPath Methode übergeben, um einen vollqualifizierten Pfad zum Datenverzeichnis der Anwendung abzurufen.

using System;
using System.IO;

class Program
{
    static void Main()
    {
        string basePath = Environment.CurrentDirectory;
        string relativePath = "./data/output.xml";
 
        // Unexpectedly change the current directory.
        Environment.CurrentDirectory = "C:/Users/Public/Documents/";
        
        string fullPath = Path.GetFullPath(relativePath, basePath);
        Console.WriteLine($"Current directory:\n   {Environment.CurrentDirectory}");
        Console.WriteLine($"Fully qualified path:\n   {fullPath}");
    }
}
// The example displays the following output:
//   Current directory:
//      C:\Users\Public\Documents
//   Fully qualified path:
//      C:\Utilities\data\output.xml

Imports System.IO

Module Program
    Public Sub Main()
        Dim basePath As String = Environment.CurrentDirectory
        Dim relativePath As String = "./data/output.xml"
 
        ' Unexpectedly change the current directory.
        Environment.CurrentDirectory = "C:/Users/Public/Documents/"
        
        Dim fullPath As String = Path.GetFullPath(relativePath, basePath)
        Console.WriteLine($"Current directory:\n   {Environment.CurrentDirectory}")
        Console.WriteLine($"Fully qualified path:\n   {fullPath}")
    End Sub
End Module
' The example displays the following output:
'   Current directory:
'      C:\Users\Public\Documents
'   Fully qualified path:
'      C:\Utilities\data\output.xml

Hinweise

Wenn path es sich um einen leeren Pfad handelt, gibt die Methode zurück basePath. Wenn path es sich um einen vollqualifizierten Pfad handelt, übergibt path die Methode an die GetFullPath(String) Methode und gibt das Ergebnis zurück.

Verwenden Sie diese Methode, um einen deterministischen Pfad basierend auf einem angegebenen Volume und einem rootigen Verzeichnis zurückzugeben, wenn Sie relative Pfade verwenden. Die Verwendung eines vordefinierten basePath und nicht eines auf dem aktuellen Laufwerkverzeichnis basiert, schützt vor unerwünschten Dateipfaden, die durch unerwartete Änderungen im aktuellen Laufwerk und Verzeichnis verursacht werden.

public:
 static System::String ^ GetFullPath(System::String ^ path);

public static string GetFullPath(string path);

static member GetFullPath : string -> string

Public Shared Function GetFullPath (path As String) As String

Parameter

Gibt zurück

Der vollqualifizierte Standort von path, z. B. "C:\MyFile.txt".

Ausnahmen

Beispiele

Im folgenden Beispiel wird die GetFullPath-Methode auf einer Windows-basierten Desktopplattform veranschaulicht.

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'

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'

Hinweise

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

Die angegebene Datei oder das angegebene path Verzeichnis ist nicht erforderlich. Wenn z. B. c:\temp\newdir das aktuelle Verzeichnis ist, GetFullPath wird ein Dateiname wie test.txt"c:\temp\newdir\test.txt" zurückgegeben. Die Datei muss nicht vorhanden sein.

Falls path vorhanden, muss der Aufrufer jedoch über die Berechtigung zum Abrufen von Pfadinformationen verfügen.path Beachten Sie, dass diese Methode im Gegensatz zu den meisten Membern der Path Klasse auf das Dateisystem zugreift.

Diese Methode verwendet das aktuelle Verzeichnis und die aktuellen Volumeinformationen, um vollständig zu qualifizieren path. Wenn Sie nur patheinen Dateinamen angeben, GetFullPath wird der vollqualifizierte Pfad des aktuellen Verzeichnisses zurückgegeben.

Wenn Sie einen kurzen Dateinamen übergeben, wird er auf einen langen Dateinamen erweitert.

Wenn ein Pfad keine signifikanten Zeichen enthält, ist er ungültig, es sei denn, er enthält ein oder mehrere "."-Zeichen, gefolgt von einer beliebigen Anzahl von Leerzeichen; dann wird sie als "." oder "." analysiert.

.NET Core 1.1 und höher sowie .NET Framework 4.6.2 und höher unterstützen auch Pfade, die Gerätenamen enthalten, z. B. "\\?\C:\".

Weitere Informationen zu Dateiformaten unter Windows finden Sie unter Dateipfadformate auf Windows-Systemen. Eine Liste allgemeiner E/A-Aufgaben finden Sie unter "Allgemeine E/A-Aufgaben".

Weitere Informationen

• File-Pfadformate auf Windows Systemen
• Datei- und Stream-E/A
• Vorgehensweise: Lesen von Text aus einer Datei
• Vorgehensweise: Schreiben von Text in eine Datei