Path.Join 方法

定义

重载

Join(String, String, String, String)

将四个路径串联成一个路径。

Join(ReadOnlySpan<Char>, ReadOnlySpan<Char>, ReadOnlySpan<Char>, ReadOnlySpan<Char>)

将四个路径组件串联成一个路径。

Join(String, String, String)

将三个路径串联成一个路径。

Join(ReadOnlySpan<Char>, ReadOnlySpan<Char>, ReadOnlySpan<Char>)

将三个路径组件串联成一个路径。

Join(ReadOnlySpan<String>)

将一系列路径连接成一个路径。

Join(ReadOnlySpan<Char>, ReadOnlySpan<Char>)

将两个路径组件串联成一个路径。

Join(String[])

将路径数组串联成单个路径。

Join(String, String)

将两个路径连接成一个路径。

Join(String, String, String, String)

Source:
Path.cs
Source:
Path.cs
Source:
Path.cs

将四个路径串联成一个路径。

public:
 static System::String ^ Join(System::String ^ path1, System::String ^ path2, System::String ^ path3, System::String ^ path4);
public static string Join (string? path1, string? path2, string? path3, string? path4);
static member Join : string * string * string * string -> string
Public Shared Function Join (path1 As String, path2 As String, path3 As String, path4 As String) As String

参数

path1
String

要联接的第一个路径。

path2
String

要联接的第二个路径。

path3
String

要联接的第三个路径。

path4
String

要联接的第四个路径。

返回

串联的路径。

注解

此方法只需连接 pathpath2path3path4,并在任何路径组件之间添加目录分隔符(如果尚不存在)。 如果任一 path1path2path3path4 参数的长度为零,则该方法将连接其余参数。 如果生成的串联字符串的长度为零,该方法将返回 String.Empty

如果 path1path2path3 以不适合目标平台的路径分隔符结尾,Join 方法将保留原始路径分隔符并追加受支持的分隔符。 此问题发生在使用 Windows 反斜杠 (“\”) 字符的硬编码路径中,该字符在基于 Unix 的系统上无法识别为路径分隔符。 若要解决此问题,可以:

Combine 方法不同,Join 方法不会尝试对返回的路径进行根。 (也就是说,如果 path2path3path4 是绝对路径,Join 方法不会像 Combine 方法那样放弃以前的路径。

并非所有目录和文件名的无效字符都将被 Join 方法解释为不可接受的,因为你可以使用这些字符来搜索通配符。 例如,虽然创建文件时 Path.Join("c:\\", "temp", "*.txt") 可能无效,但它作为搜索字符串有效。 因此,Join 方法已成功解释它。

适用于

Join(ReadOnlySpan<Char>, ReadOnlySpan<Char>, ReadOnlySpan<Char>, ReadOnlySpan<Char>)

Source:
Path.cs
Source:
Path.cs
Source:
Path.cs

将四个路径组件串联成一个路径。

public:
 static System::String ^ Join(ReadOnlySpan<char> path1, ReadOnlySpan<char> path2, ReadOnlySpan<char> path3, ReadOnlySpan<char> path4);
public static string Join (ReadOnlySpan<char> path1, ReadOnlySpan<char> path2, ReadOnlySpan<char> path3, ReadOnlySpan<char> path4);
static member Join : ReadOnlySpan<char> * ReadOnlySpan<char> * ReadOnlySpan<char> * ReadOnlySpan<char> -> string
Public Shared Function Join (path1 As ReadOnlySpan(Of Char), path2 As ReadOnlySpan(Of Char), path3 As ReadOnlySpan(Of Char), path4 As ReadOnlySpan(Of Char)) As String

参数

path1
ReadOnlySpan<Char>

包含要联接的第一个路径的字符范围。

path2
ReadOnlySpan<Char>

包含要联接的第二个路径的字符范围。

path3
ReadOnlySpan<Char>

包含要联接的第三个路径的字符范围。

path4
ReadOnlySpan<Char>

包含要联接的第四个路径的字符范围。

返回

串联的路径。

注解

此方法只需连接 pathpath2path3path4,并在任何路径组件之间添加目录分隔符(如果尚不存在)。 如果任一 path1path2path3path4 参数的 Length 为零,则该方法将连接其余参数。 如果所有组件的 ReadOnlySpan<T>.Length 为零,该方法将返回 String.Empty

如果 path1path2path3 以不适合目标平台的路径分隔符结尾,Join 方法将保留原始路径分隔符并追加受支持的分隔符。 此问题发生在使用 Windows 反斜杠 (“\”) 字符的硬编码路径中,该字符在基于 Unix 的系统上无法识别为路径分隔符。 若要解决此问题,可以:

Combine 方法不同,Join 方法不会尝试对返回的路径进行根。 (也就是说,如果 path2path3path4 是绝对路径,Join 方法不会像 Combine 方法那样放弃以前的路径。

并非所有目录和文件名的无效字符都将被 Join 方法解释为不可接受的,因为你可以使用这些字符来搜索通配符。 例如,虽然创建文件时 Path.Join("c:\\", "temp", "*.txt") 可能无效,但它作为搜索字符串有效。 因此,Join 方法已成功解释它。

适用于

Join(String, String, String)

Source:
Path.cs
Source:
Path.cs
Source:
Path.cs

将三个路径串联成一个路径。

public:
 static System::String ^ Join(System::String ^ path1, System::String ^ path2, System::String ^ path3);
public static string Join (string? path1, string? path2, string? path3);
static member Join : string * string * string -> string
Public Shared Function Join (path1 As String, path2 As String, path3 As String) As String

参数

path1
String

要联接的第一个路径。

path2
String

要联接的第二个路径。

path3
String

要联接的第三个路径。

返回

串联的路径。

注解

此方法只需连接 pathpath2path3,并在任何路径组件之间添加目录分隔符(如果尚不存在)。 如果任一 path1path2path3 参数的长度为零,则该方法将连接其余参数。 如果生成的串联字符串的长度为零,该方法将返回 String.Empty

如果 path1path2 以不适合目标平台的路径分隔符结尾,Join 方法将保留原始路径分隔符并追加受支持的分隔符。 此问题发生在使用 Windows 反斜杠 (“\”) 字符的硬编码路径中,该字符在基于 Unix 的系统上无法识别为路径分隔符。 若要解决此问题,可以:

Combine 方法不同,Join 方法不会尝试对返回的路径进行根。 (也就是说,如果 path2path3 是绝对路径,Join 方法不会像 Combine 方法那样放弃以前的路径。

并非所有目录和文件名的无效字符都将被 Join 方法解释为不可接受的,因为你可以使用这些字符来搜索通配符。 例如,虽然创建文件时 Path.Join("c:\\", "temp", "*.txt") 可能无效,但它作为搜索字符串有效。 因此,Join 方法已成功解释它。

适用于

Join(ReadOnlySpan<Char>, ReadOnlySpan<Char>, ReadOnlySpan<Char>)

Source:
Path.cs
Source:
Path.cs
Source:
Path.cs

将三个路径组件串联成一个路径。

public:
 static System::String ^ Join(ReadOnlySpan<char> path1, ReadOnlySpan<char> path2, ReadOnlySpan<char> path3);
public static string Join (ReadOnlySpan<char> path1, ReadOnlySpan<char> path2, ReadOnlySpan<char> path3);
static member Join : ReadOnlySpan<char> * ReadOnlySpan<char> * ReadOnlySpan<char> -> string
Public Shared Function Join (path1 As ReadOnlySpan(Of Char), path2 As ReadOnlySpan(Of Char), path3 As ReadOnlySpan(Of Char)) As String

参数

path1
ReadOnlySpan<Char>

包含要联接的第一个路径的字符范围。

path2
ReadOnlySpan<Char>

包含要联接的第二个路径的字符范围。

path3
ReadOnlySpan<Char>

包含要联接的第三个路径的字符范围。

返回

串联的路径。

示例

以下示例说明了 Path.Join(ReadOnlySpan<Char>, ReadOnlySpan<Char>, ReadOnlySpan<Char>)Path.Combine(String, String, String) 方法返回的路径之间的差异。 当第一个字符串是包含驱动器和根目录的完全限定路径,第二个字符串是第一个路径的相对路径时,这两种方法会产生相同的结果。 在对 ShowPathInformation 方法的第二次和第三次调用中,两个方法返回的字符串会不同。 在第二个方法调用中,第一个字符串参数是驱动器,而第二个参数是根目录。 Join 方法连接两个字符串并保留重复的路径分隔符。 对 GetFullPath 方法的调用将消除重复。 Combine 方法放弃驱动器,并返回当前驱动器上的根目录。 如果应用程序的当前驱动器为 C:\ 并且字符串用于访问目录中的文件或文件,则它将访问 C:而不是 D:。 最后,由于对 ShowPathInformation 的第三次调用中的最后一个参数是根的,因此 Join 方法只需将其追加到前两个参数以创建不区分的文件路径,而 Combine 方法将放弃前两个字符串并返回第三个字符串。 使用此字符串进行文件访问可能会使应用程序对敏感文件进行意外访问。

using System;
using System.IO;

class Program3
{
    static void Main()
    {
        ShowPathInformation("C:/", "users/user1/documents", "letters");
        ShowPathInformation("D:/", "/users/user1/documents", "letters");
        ShowPathInformation("D:/", "users/user1/documents", "C:/users/user1/documents/data");
    }

   private static void ShowPathInformation(string path1, string path2, string path3)
    {
        Console.WriteLine($"Concatenating  '{path1}', '{path2}', and '{path3}'");
        Console.WriteLine($"   Path.Join:     '{Path.Join(path1, path2, path3)}'");
        Console.WriteLine($"   Path.Combine:  '{Path.Combine(path1, path2, path3)}'");
        Console.WriteLine($"   {Path.GetFullPath(Path.Join(path1, path2, path3))}");
    }
}
// The example displays the following output if run on a Windows system:
// Concatenating  'C:/', 'users/user1/documents', and 'letters'
//    Path.Join:     'C:/users/user1/documents\letters'
//    Path.Combine:  'C:/users/user1/documents\letters'
//    C:\users\user1\documents\letters
// Concatenating  'D:/', '/users/user1/documents', and 'letters'
//    Path.Join:     'D://users/user1/documents\letters'
//    Path.Combine:  '/users/user1/documents\letters'
//    D:\users\user1\documents\letters
// Concatenating  'D:/', 'users/user1/documents', and 'C:/users/user1/documents/data'
//    Path.Join:     'D:/users/user1/documents\C:/users/user1/documents/data'
//    Path.Combine:  'C:/users/user1/documents/data'
//    D:\users\user1\documents\C:\users\user1\documents\data
Imports System.IO

Module Program
    Public Sub Main()
        Dim path1 As String = "C:/"
        Dim path2 As String = "users/user1/documents"
        Dim path3 As String = "letters"
        ShowPathInformation(path1, path2, path3)
        
        path1 = "D:/"
        path2 =  "/users/user1/documents"
        path3 = "letters"
        ShowPathInformation(path1, path2, path3)

        path1 = "D:/"
        path2 =  "users/user1/documents"
        path3 = "C:/users/user1/documents/data"
        ShowPathInformation(path1, path2, path3)
    End Sub

   Private Sub ShowPathInformation(path1 As String, path2 As String, path3 As String)
        Dim result = Path.Join(path1.AsSpan(), path2.AsSpan(), path3.AsSpan())
        Console.WriteLine($"Concatenating  '{path1}, '{path2}', and `{path3}'")
        Console.WriteLine($"   Path.Join:     '{result}'")
        Console.WriteLine($"   Path.Combine:  '{Path.Combine(path1, path2, path3)}'")
    End Sub
End Module
' The example displays the following output if run on a Windows system:
'   Concatenating  'C:/, 'users/user1/documents', and `letters'
'      Path.Join:     'C:/users/user1/documents\letters'
'      Path.Combine:  'C:/users/user1/documents\letters'
'
'   Concatenating  'D:/, '/users/user1/documents', and `letters'
'      Path.Join:     'D:'users/user1/documents\letters'
'      Path.Combine:  '/users/user1/documents\letters'
'
'   Concatenating  'D:/, 'users/user1/documents', and `C:/users/user1/documents/data'
'      Path.Join:     'D:/users/user1/documents\C:/users/user1/documents/data'
'      Path.Combine:  'C:/users/user1/documents/data'

注解

此方法只需连接 pathpath2path3,并在任何路径组件之间添加目录分隔符(如果尚不存在)。 如果任一 path1path2path3 参数的 Length 为零,则该方法将连接其余参数。 如果所有组件的 ReadOnlySpan<T>.Length 为零,该方法将返回 String.Empty

如果 path1path2 以不适合目标平台的路径分隔符结尾,Join 方法将保留原始路径分隔符并追加受支持的分隔符。 此问题发生在使用 Windows 反斜杠 (“\”) 字符的硬编码路径中,该字符在基于 Unix 的系统上无法识别为路径分隔符。 若要解决此问题,可以:

Combine 方法不同,Join 方法不会尝试对返回的路径进行根。 (也就是说,如果 path2path3 是绝对路径,Join 方法不会像 Combine 方法那样放弃以前的路径。

并非所有目录和文件名的无效字符都将被 Join 方法解释为不可接受的,因为你可以使用这些字符来搜索通配符。 例如,虽然创建文件时 Path.Join("c:\\", "temp", "*.txt") 可能无效,但它作为搜索字符串有效。 因此,Join 方法已成功解释它。

另请参阅

适用于

Join(ReadOnlySpan<String>)

将一系列路径连接成一个路径。

public:
 static System::String ^ Join(ReadOnlySpan<System::String ^> paths);
public static string Join (scoped ReadOnlySpan<string?> paths);
static member Join : ReadOnlySpan<string> -> string
Public Shared Function Join (paths As ReadOnlySpan(Of String)) As String

参数

paths
ReadOnlySpan<String>

路径范围。

返回

串联的路径。

适用于

Join(ReadOnlySpan<Char>, ReadOnlySpan<Char>)

Source:
Path.cs
Source:
Path.cs
Source:
Path.cs

将两个路径组件串联成一个路径。

public:
 static System::String ^ Join(ReadOnlySpan<char> path1, ReadOnlySpan<char> path2);
public static string Join (ReadOnlySpan<char> path1, ReadOnlySpan<char> path2);
static member Join : ReadOnlySpan<char> * ReadOnlySpan<char> -> string
Public Shared Function Join (path1 As ReadOnlySpan(Of Char), path2 As ReadOnlySpan(Of Char)) As String

参数

path1
ReadOnlySpan<Char>

包含要联接的第一个路径的字符范围。

path2
ReadOnlySpan<Char>

包含要联接的第二个路径的字符范围。

返回

组合路径。

示例

以下示例说明了 Path.Join(ReadOnlySpan<Char>, ReadOnlySpan<Char>)Path.Combine(String, String) 方法返回的路径之间的差异。 当第一个字符串是包含驱动器和根目录的完全限定路径,第二个是第一个路径的相对路径时,这两种方法会产生相同的结果。 在对 ShowPathInformation 方法的第二次和第三次调用中,两个方法返回的字符串会不同。 在第二个方法调用中,第一个字符串参数是驱动器,而第二个参数是根目录。 Join 方法连接两个字符串并保留重复的路径分隔符。 Combine 方法放弃驱动器,并返回当前驱动器上的根目录。 如果应用程序的当前驱动器为 C:\ 并且字符串用于访问目录中的文件或文件,则它将访问 C:而不是 D:。 最后,由于第三次调用 ShowPathInformation 中的两个参数都已建立根,因此 Join 方法只需追加它们以创建不区分的文件路径,而 Combine 方法放弃第一个字符串并返回第二个字符串。 使用此字符串进行文件访问可能会使应用程序对敏感文件进行意外访问。

using System;
using System.IO;

class Program2
{
    static void Main()
    {
        var path1 = "C:/Program Files/";
        var path2 = "Utilities/SystemUtilities";
        ShowPathInformation(path1, path2);

        path1 = "C:/";
        path2 = "/Program Files";
        ShowPathInformation(path1, path2);

        path1 = "C:/Users/Public/Documents/";
        path2 = "C:/Users/User1/Documents/Financial/";
        ShowPathInformation(path1, path2);
    }

    private static void ShowPathInformation(string path1, string path2)
    {
        var result = Path.Join(path1.AsSpan(), path2.AsSpan());
        Console.WriteLine($"Concatenating  '{path1}' and '{path2}'");
        Console.WriteLine($"   Path.Join:     '{result}'");
        Console.WriteLine($"   Path.Combine:  '{Path.Combine(path1, path2)}'");
    }
}
// The example displays the following output if run on a Windows system:
//    Concatenating  'C:/Program Files/' and 'Utilities/SystemUtilities'
//       Path.Join:     'C:/Program Files/Utilities/SystemUtilities'
//       Path.Combine:  'C:/Program Files/Utilities/SystemUtilities'
//
//    Concatenating  'C:/' and '/Program Files'
//       Path.Join:     'C://Program Files'
//       Path.Combine:  '/Program Files'
//
//    Concatenating  'C:/Users/Public/Documents/' and 'C:/Users/User1/Documents/Financial/'
//       Path.Join:     'C:/Users/Public/Documents/C:/Users/User1/Documents/Financial/'
//       Path.Combine:  'C:/Users/User1/Documents/Financial/'
Imports System.IO

Module Example
    Public Sub Main()
        Dim path1 = "C:/Program Files/"
        Dim path2 = "Utilities/SystemUtilities"
        ShowPathInformation(path1, path2)

        path1 = "C:/"
        path2 = "/Program Files"
        ShowPathInformation(path1, path2)

        path1 = "C:/Users/Public/Documents/"
        path2 = "C:/Users/User1/Documents/Financial/"
        ShowPathInformation(path1, path2)
    End Sub

    Private Sub ShowPathInformation(path1 As String, path2 As String)
        Dim result = Path.Join(path1.AsSpan(), path2.AsSpan())
        Console.WriteLine($"Concatenating  '{path1}' and '{path2}'")
        Console.WriteLine($"   Path.Join:     '{result}'")
        Console.WriteLine($"   Path.Combine:  '{Path.Combine(path1, path2)}'")
        Console.WriteLine()
    End Sub
End Module
' The example displays the following output if run on a Windows system:
'    Concatenating  'C:/Program Files/' and 'Utilities/SystemUtilities'
'       Path.Join:     'C:/Program Files/Utilities/SystemUtilities'
'       Path.Combine:  'C:/Program Files/Utilities/SystemUtilities'
'
'    Concatenating  'C:/' and '/Program Files'
'       Path.Join:     'C:'Program Files'
'       Path.Combine:  '/Program Files'
'
'    Concatenating  'C:/Users/Public/Documents/' and 'C:/Users/User1/Documents/Financial/'
'       Path.Join:     'C:/Users/Public/Documents/C:/Users/User1/Documents/Financial/'
'       Path.Combine:  'C:/Users/User1/Documents/Financial/'

注解

此方法只是连接 pathpath2,并在两个路径组件之间添加目录分隔符(如果 path1 末尾或 path2开头尚不存在)。 如果 path1path2Length 为零,该方法将返回另一个路径。 如果 path1path2Length 为零,该方法将返回 String.Empty

如果 path1 以不适合目标平台的路径分隔符结尾,Join 方法将保留原始路径分隔符并追加受支持的分隔符。 此问题发生在使用 Windows 反斜杠 (“\”) 字符的硬编码路径中,该字符在基于 Unix 的系统上无法识别为路径分隔符。 若要解决此问题,可以:

Combine 方法不同,Join 方法不会尝试对返回的路径进行根。 (也就是说,如果 path2 是绝对路径,Join 方法不会放弃 path1,并返回 path2,就像 Combine 方法一样。下面的示例说明了两种方法返回的路径之间的差异。 如果 path2 的源是用户输入,则 Combine 方法使用户能够访问文件系统资源(如 c:/Users/User1/Documents/Financial/(在本示例中),应用程序不打算进行访问。

并非所有目录和文件名的无效字符都将被 Join 方法解释为不可接受的,因为你可以使用这些字符来搜索通配符。 例如,虽然创建文件时 Path.Join("c:\\", "*.txt") 可能无效,但它作为搜索字符串有效。 因此,Join 方法已成功解释它。

另请参阅

适用于

Join(String[])

Source:
Path.cs
Source:
Path.cs
Source:
Path.cs

将路径数组串联成单个路径。

public:
 static System::String ^ Join(... cli::array <System::String ^> ^ paths);
public static string Join (params string?[] paths);
static member Join : string[] -> string
Public Shared Function Join (ParamArray paths As String()) As String

参数

paths
String[]

路径数组。

返回

串联的路径。

注解

此方法只是连接 paths 中的所有字符串,并在任何路径组件之间添加目录分隔符(如果尚不存在)。 如果 paths 中任何路径的 Length 为零,该方法将连接其余参数。 如果生成的串联字符串长度为零,该方法将返回 String.Empty

如果 paths中的任何路径(最后一个路径除外)以不适合目标平台的路径分隔符结尾,Join 方法将保留原始路径分隔符并追加受支持的路径分隔符。 此问题发生在使用 Windows 反斜杠 (“\”) 字符的硬编码路径中,该字符在基于 Unix 的系统上无法识别为路径分隔符。 若要解决此问题,可以:

Combine 方法不同,Join 方法不会尝试对返回的路径进行根。 (也就是说,如果 paths中的任何路径(第一个路径除外)是绝对路径,Join 方法不会像 Combine 方法那样放弃以前的路径。

并非所有目录和文件名的无效字符都将被 Join 方法解释为不可接受的,因为你可以使用这些字符来搜索通配符。 例如,虽然创建文件时 Path.Join("c:\\", "temp", "*.txt") 可能无效,但它作为搜索字符串有效。 因此,Join 方法已成功解释它。

适用于

Join(String, String)

Source:
Path.cs
Source:
Path.cs
Source:
Path.cs

将两个路径连接成一个路径。

public:
 static System::String ^ Join(System::String ^ path1, System::String ^ path2);
public static string Join (string? path1, string? path2);
static member Join : string * string -> string
Public Shared Function Join (path1 As String, path2 As String) As String

参数

path1
String

要联接的第一个路径。

path2
String

要联接的第二个路径。

返回

串联的路径。

注解

此方法只是连接 pathpath2,并在任何路径组件之间添加目录分隔符(如果尚不存在)。 如果 path1path2 的长度为零,则该方法将连接其余参数。 如果生成的串联字符串的长度为零,该方法将返回 String.Empty

如果 path1 以不适合目标平台的路径分隔符结尾,Join 方法将保留原始路径分隔符并追加受支持的分隔符。 此问题发生在使用 Windows 反斜杠 (“\”) 字符的硬编码路径中,该字符在基于 Unix 的系统上无法识别为路径分隔符。 若要解决此问题,可以:

Combine 方法不同,Join 方法不会尝试对返回的路径进行根。 (也就是说,如果 path2 是绝对路径,Join 方法不会像 Combine 方法那样放弃以前的路径。

并非所有目录和文件名的无效字符都将被 Join 方法解释为不可接受的,因为你可以使用这些字符来搜索通配符。 例如,虽然创建文件时 Path.Join("c:\\", "temp", "*.txt") 可能无效,但它作为搜索字符串有效。 因此,Join 方法已成功解释它。

适用于