Path 類別

public ref class Path abstract sealed

public ref class Path sealed

public static class Path

public sealed class Path

[System.Runtime.InteropServices.ComVisible(true)]
public static class Path

type Path = class

[<System.Runtime.InteropServices.ComVisible(true)>]
type Path = class

Public Class Path

Public NotInheritable Class Path

繼承

Object

Path

屬性

ComVisibleAttribute

下列範例示範 Path 類別的一些主要成員。

using namespace System;
using namespace System::IO;
int main()
{
   String^ path1 = "c:\\temp\\MyTest.txt";
   String^ path2 = "c:\\temp\\MyTest";
   String^ path3 = "temp";
   if ( Path::HasExtension( path1 ) )
   {
      Console::WriteLine( "{0} has an extension.", path1 );
   }

   if (  !Path::HasExtension( path2 ) )
   {
      Console::WriteLine( "{0} has no extension.", path2 );
   }

   if (  !Path::IsPathRooted( path3 ) )
   {
      Console::WriteLine( "The string {0} contains no root information.", path3 );
   }

   Console::WriteLine( "The full path of {0} is {1}.", path3, Path::GetFullPath( path3 ) );
   Console::WriteLine( "{0} is the location for temporary files.", Path::GetTempPath() );
   Console::WriteLine( "{0} is a file available for use.", Path::GetTempFileName() );
   Console::WriteLine( "\r\nThe set of invalid characters in a path is:" );
   Console::WriteLine( "(Note that the wildcard characters '*' and '?' are not invalid.):" );
   Collections::IEnumerator^ myEnum = Path::InvalidPathChars->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Char c =  *safe_cast<Char^>(myEnum->Current);
      Console::WriteLine( c );
   }
}

using System;
using System.IO;

class Test
{
    
    public static void Main()
    {
        string path1 = @"c:\temp\MyTest.txt";
        string path2 = @"c:\temp\MyTest";
        string path3 = @"temp";

        if (Path.HasExtension(path1))
        {
            Console.WriteLine("{0} has an extension.", path1);
        }

        if (!Path.HasExtension(path2))
        {
            Console.WriteLine("{0} has no extension.", path2);
        }

        if (!Path.IsPathRooted(path3))
        {
            Console.WriteLine("The string {0} contains no root information.", path3);
        }

        Console.WriteLine("The full path of {0} is {1}.", path3, Path.GetFullPath(path3));
        Console.WriteLine("{0} is the location for temporary files.", Path.GetTempPath());
        Console.WriteLine("{0} is a file available for use.", Path.GetTempFileName());

        /* This code produces output similar to the following:
         * c:\temp\MyTest.txt has an extension.
         * c:\temp\MyTest has no extension.
         * The string temp contains no root information.
         * The full path of temp is D:\Documents and Settings\cliffc\My Documents\Visual Studio 2005\Projects\ConsoleApplication2\ConsoleApplication2\bin\Debug\temp.
         * D:\Documents and Settings\cliffc\Local Settings\Temp\8\ is the location for temporary files.
         * D:\Documents and Settings\cliffc\Local Settings\Temp\8\tmp3D.tmp is a file available for use.
         */
    }
}

Imports System.IO

Public Class Test

    Public Shared Sub Main()
        Dim path1 As String = "c:\temp\MyTest.txt"
        Dim path2 As String = "c:\temp\MyTest"
        Dim path3 As String = "temp"

        If Path.HasExtension(path1) Then
            Console.WriteLine("{0} has an extension.", path1)
        End If

        If Path.HasExtension(path2) = False Then
            Console.WriteLine("{0} has no extension.", path2)
        End If

        If Path.IsPathRooted(path3) = False Then
            Console.WriteLine("The string {0} contains no root information.", path3)
        End If

        Console.WriteLine("The full path of {0} is {1}.", path3, Path.GetFullPath(path3))
        Console.WriteLine("{0} is the location for temporary files.", Path.GetTempPath())
        Console.WriteLine("{0} is a file available for use.", Path.GetTempFileName())

        ' This code produces output similar to the following:
        ' c:\temp\MyTest.txt has an extension.
        ' c:\temp\MyTest has no extension.
        ' The string temp contains no root information.
        ' The full path of temp is D:\Documents and Settings\cliffc\My Documents\Visual Studio 2005\Projects\ConsoleApplication2\ConsoleApplication2\bin\Debug\temp.
        ' D:\Documents and Settings\cliffc\Local Settings\Temp\8\ is the location for temporary files.
        ' D:\Documents and Settings\cliffc\Local Settings\Temp\8\tmp3D.tmp is a file available for use.

    End Sub
End Class

路徑是提供檔案或目錄位置的字串。 路徑不一定指向磁碟上的位置;例如，路徑可能會對應至記憶體中或裝置上的位置。 路徑的確切格式是由目前的平臺所決定。 例如，在某些系統上，路徑可以從磁碟驅動器或磁碟驅動器號開始，而這個專案在其他系統中則不存在。 在某些系統上，檔案路徑可以包含延伸模組，指出儲存在檔案中的資訊類型。 擴展名的格式與平台相關;例如，某些系統會將擴充功能限制為三個字元（例如在較小的快閃記憶體上常用的 FAT16，以及在光學媒體上使用的舊版 ISO 9660），而其他則不會。 目前的平臺也會決定用來分隔路徑元素的字元集，以及指定路徑時無法使用的字元集。 由於這些差異，Path 類別的欄位以及 Path 類別中某些成員的確切行為都是平臺相依的。

路徑可以包含絕對或相對位置資訊。 絕對路徑完全指定位置：不論目前的位置為何，都可以唯一識別檔案或目錄。 相對路徑會指定部分位置：尋找以相對路徑指定的檔案時，會使用目前的位置作為起點。 若要判斷目前目錄，請呼叫 Directory.GetCurrentDirectory。

.NET Core 1.1 和更新版本和 .NET Framework 4.6.2 和更新版本也支援存取屬於裝置名稱的文件系統物件，例如 “\？\C：\”。

如需 Windows 上檔案路徑格式的詳細資訊，請參閱 Windows 系統上的檔案路徑格式。

Path 類別的大部分成員不會與文件系統互動，也不會驗證路徑字串所指定的檔案是否存在。 Path 修改路徑字串的類別成員，例如 ChangeExtension，對文件系統中的檔名沒有任何影響。

某些 Path 成員會驗證指定路徑字串的內容，如果字串包含路徑字串中無效的字元，則擲回 ArgumentException，如從 GetInvalidPathChars 方法傳回的字元中所定義。 例如，在 Windows 桌面平臺上，無效的路徑字元可能包含引號 （）、小於 （<）、大於 （>）、管道 （|）、後空 （\b）、null （\0），以及 Unicode 字元 16 到 18 到 20 到 25。 此驗證行為會因 .NET 版本而異：

• 在 2.1 之前的 .NET Framework 和 .NET Core 版本上：如果成員偵測到無效的路徑字元，則會擲回路徑做為自變數的所有 Path 成員都會擲回 ArgumentException。

• 在 .NET Core 2.1 和更新版本上：如果字串包含無效的路徑字元，GetFullPath 是唯一擲回 ArgumentException 的成員。

Path 類別的成員可讓您快速且輕鬆地執行一般作業，例如判斷擴展名是否為路徑的一部分，以及將兩個字串結合成一個路徑名稱。

Path 類別的所有成員都是靜態的，因此不需要路徑的實例即可呼叫。

在接受路徑的成員中，路徑可以參考檔案或只參考目錄。 指定的路徑也可以參考伺服器和共享名稱的相對路徑或通用命名慣例 （UNC） 路徑。 例如，下列所有都是可接受的路徑：

• “c：\MyDir\MyFile.txt”in C#， or “c：\MyDir\MyFile.txt” in Visual Basic.

• C# 中的 “c：\MyDir” 或 Visual Basic 中的 “c：\MyDir”。

• C# 中的 “MyDir\MySubdir” 或 Visual Basic 中的 “MyDir\MySubDir”。

• C# 中的 “\\MyServer\MyShare” 或 Visual Basic 中的 “\MyServer\MyShare”。

由於所有這些作業都是在字串上執行，因此不可能在所有案例中驗證結果是否有效。 例如，GetExtension 方法會剖析您傳遞給它的字串，並從該字串傳回延伸模組。 不過，這並不表示該擴展名的檔案存在於磁碟上。

如需一般 I/O 工作的清單，請參閱 一般 I/O 工作。

• 檔案和串流 I/O
• 如何：從檔案讀取文字
• 如何：將文字寫入檔案
• 如何：讀取和寫入新建立的數據檔
• Windows 系統上的檔案路徑格式