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

示例

下面的示例演示 类的一些main成员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成员会验证指定路径字符串的内容，如果字符串包含路径字符串中无效的字符（如 方法返回GetInvalidPathChars的字符中定义），则会引发 ArgumentException 。 例如，在基于 Windows 的桌面平台上，无效的路径字符可能包括引号 (“) 、小于 (<) 、大于 (>) 、管道 (|) 、backspace (\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# 中的“c:\\MyDir\\MyFile.txt”或 Visual Basic 中的“c:\MyDir\MyFile.txt”。

• 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 系统中的文件路径格式