Path.GetFullPath Yöntem

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Aşırı Yüklemeler

Name	Description
GetFullPath(String)	Belirtilen yol dizesi için mutlak yolu döndürür.
GetFullPath(String, String)	Göreli bir yoldan mutlak bir yol ve tam taban yol döndürür.

GetFullPath(String)

Kaynak:

Path.Unix.cs

Belirtilen yol dizesi için mutlak yolu döndürür.

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

Parametreler

path

String

Mutlak yol bilgilerinin alındığı dosya veya dizin.

Döndürülenler

String

öğesinin path"C:\MyFile.txt" gibi tam konumu.

Özel durumlar

ArgumentException

path sıfır uzunluklu bir dizedir, yalnızca Windows sistemlerinde boşluk içerir veya GetInvalidPathChars() içinde tanımlanan geçersiz karakterlerden birini veya daha fazlasını içerir.

-veya-

Sistem mutlak yolu alamadı.

SecurityException

Çağıranın gerekli izinleri yok.

ArgumentNullException

path, null'e eşittir.

NotSupportedException

Yalnızca .NET Framework: path bir birim tanımlayıcısının parçası olmayan iki nokta üst üste (":") içerir (örneğin, "c:\").

PathTooLongException

Belirtilen yol, dosya adı veya her ikisi de sistem tanımlı uzunluk üst sınırını aşıyor.

Örnekler

Aşağıdaki örnek, Windows tabanlı bir masaüstü platformunda GetFullPath yöntemini gösterir.

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'

Açıklamalar

Mutlak yol, sistemdeki bir dosyayı veya dizini bulmak için gereken tüm bilgileri içerir.

tarafından path belirtilen dosya veya dizinin var olması gerekli değildir. Örneğin, geçerli dizin c:\temp\newdir ise, GetFullPath gibi bir dosya adına çağrılması c:\temp\newdir\test.txtdöndürür. Dosyanın mevcut olması gerekmez.

Important

Göreli bir yolsa path , bu aşırı yükleme geçerli sürücüyü ve geçerli dizini temel alan tam bir yol döndürür. Geçerli sürücü ve geçerli dizin, bir uygulama yürütülürken herhangi bir zamanda değişebilir. Sonuç olarak, bu aşırı yükleme tarafından döndürülen yol önceden belirlenemez. Belirleyici bir yol döndürmek için aşırı yüklemeyi çağırın GetFullPath(String, String) . Ayrıca, bir yolun tam olarak nitelenmiş mi yoksa göreli mi olduğunu ve dolayısıyla çağrısının gerekli olup olmadığını belirlemek için IsPathFullyQualified yöntemini çağırabilirsinizGetFullPath.

Ancak, varsa path , çağıranın için pathyol bilgilerini alma izni olmalıdır. Sınıfın üyelerinin çoğundan farklı olarak bu yöntemin Path dosya sistemine eriştiğine dikkat edin.

Bu yöntem, tam niteliğe sahip patholmak için geçerli dizini ve geçerli birim bilgilerini kullanır. yalnızca içinde pathGetFullPath bir dosya adı belirtirseniz, geçerli dizinin tam yolunu döndürür.

Kısa bir dosya adı geçirirseniz, uzun bir dosya adına genişletilir.

Bir yol önemli karakter içermiyorsa, bir veya daha fazla "." karakter ve ardından herhangi bir sayıda boşluk içermediği sürece geçersizdir; ardından "." veya ".." olarak ayrıştırılır.

.NET Core 1.1 ve sonraki sürümleri ile .NET Framework 4.6.2 ve sonraki sürümleri de "\\?\C:\" gibi cihaz adlarını içeren yolları destekler.

Windows'ta dosya yolu biçimleri hakkında daha fazla bilgi için bkz. Windows sistemlerinde dosya yolu biçimleri. Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.

Ayrıca bkz.

• Windows sistemlerinde Dosya yolu biçimleri
• Dosya ve Akış G/Ç'si
• Nasıl yapılır: Dosyadan Metin Okuma
• Nasıl yapılır: Dosyaya Metin Yazma

GetFullPath(String, String)

Kaynak:

Path.Unix.cs

Göreli bir yoldan mutlak bir yol ve tam taban yol döndürür.

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

Parametreler

path

String

ile birleştirmek basePathiçin göreli bir yol.

basePath

String

Tam yol başlangıcı.

Döndürülenler

String

Mutlak yol.

Özel durumlar

ArgumentNullException

path veya basePath şeklindedir null.

ArgumentException

basePath tam bir yol değildir.

-veya-

path veya basePath içinde GetInvalidPathChars()tanımlanan geçersiz karakterlerden birini veya daha fazlasını içerir.

Örnekler

Aşağıdaki örnek, basePathbir uygulamanın geçerli dizinini temsil eden bir değişkeni tanımlar. Ardından uygulamanın veri dizinine GetFullPath tam yol almak için yöntemine geçirir.

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

Açıklamalar

Boş bir yolsa path yöntemi döndürür basePath. Tam yol isepath, yöntemi yöntemine path geçer GetFullPath(String) ve sonucu döndürür.

Göreli yollar kullanırken belirtilen birime ve kök dizine dayalı belirleyici bir yol döndürmek için bu yöntemi kullanın. Geçerli sürücü dizinini temel alan bir yerine önceden tanımlanmış basePath bir kullanmak, geçerli sürücüde ve dizinde beklenmeyen değişikliklerin neden olduğu istenmeyen dosya yollarına karşı koruma sağlar.