Path 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
在包含檔案或目錄路徑資訊的 String 實例上執行作業。 這些作業會以跨平臺的方式執行。
public ref class Path abstract sealedpublic ref class Path sealedpublic static class Pathpublic sealed class Path[System.Runtime.InteropServices.ComVisible(true)]
public static class Pathtype Path = class[<System.Runtime.InteropServices.ComVisible(true)>]
type Path = classPublic Class PathPublic NotInheritable Class Path- 繼承
-
Path
- 屬性
範例
下列範例示範 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 類別的所有成員都是靜態的，因此不需要路徑的實例即可呼叫。
注意
在接受路徑做為輸入字串的成員中，該路徑的格式必須良好或引發例外狀況。 例如，如果路徑為完整，但開頭為空格，則路徑不會在 類別的方法中修剪。 因此，路徑的格式不正確，而且會引發例外狀況。 同樣地，路徑或路徑的組合不能完全限定兩次。 例如，在大部分情況下，“c：\temp c：\windows” 也會引發例外狀況。 使用接受路徑字串的方法時，請確定您的路徑格式良好。
在接受路徑的成員中，路徑可以參考檔案或只參考目錄。 指定的路徑也可以參考伺服器和共享名稱的相對路徑或通用命名慣例 （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 工作。
欄位
| AltDirectorySeparatorChar |
提供平臺特定的替代字元，用來分隔路徑字串中的目錄層級，以反映階層式文件系統組織。 |
| DirectorySeparatorChar |
提供平臺特定字元，用來分隔路徑字串中的目錄層級，以反映階層式文件系統組織。 |
| InvalidPathChars |
已淘汰.
已淘汰.
提供平臺特定的字元陣列，這個數位無法在傳遞至 Path 類別成員的路徑字串自變數中指定。 |
| PathSeparator |
平臺特定的分隔符，用來分隔環境變數中的路徑字串。 |
| VolumeSeparatorChar |
提供平臺特定的磁碟區分隔符。 |
