Path.Join 方法

參考

定義

命名空間:: System.IO

組件:: System.Runtime.dll

組件:: System.Runtime.Extensions.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

Join(String, String, String, String)	將四個路徑串連成單一路徑。
Join(ReadOnlySpan<Char>, ReadOnlySpan<Char>, ReadOnlySpan<Char>, ReadOnlySpan<Char>)	將四個路徑元件串連成單一路徑。
Join(String, String, String)	將三個路徑串連成單一路徑。
Join(String[])	將路徑陣列串連成單一路徑。
Join(String, String)	將兩個路徑串連成單一路徑。
Join(ReadOnlySpan<Char>, ReadOnlySpan<Char>)	將兩個路徑元件串連成單一路徑。
Join(ReadOnlySpan<Char>, ReadOnlySpan<Char>, ReadOnlySpan<Char>)	將三個路徑元件串連成單一路徑。

Join(String, String, String, String)

來源:: Path.cs

來源:: Path.cs

來源:: 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

第四個聯結路徑。

傳回

String

串連的路徑。

備註

如果其中一個路徑元件不存在，這個方法只會串連 path、 path2path3 和，並在path4任一路徑元件之間加入目錄分隔符。如果任何path1、 path2path3 或 path4 自變數的長度為零，則方法會串連其餘自變數。如果產生的串連字串長度為零，則方法會傳 String.Empty回。

如果 path1 或或 path3path2 結尾為不適合目標平臺的路徑分隔符，則Join方法會保留原始路徑分隔符，並附加支援的分隔符。此問題發生在使用 Windows 反斜杠 (“\”) 字元的硬式編碼路徑中，無法辨識為 Unix 系統上的路徑分隔符。若要解決此問題，您可以：

擷取屬性的值， Path.DirectorySeparatorChar 而不是硬式編碼目錄分隔符。
使用正斜線 (“/”) 做為目錄分隔符。這個字元是由 Path.DirectorySeparatorChar Unix 系統上的屬性和 Windows 系統上的屬性所 Path.AltDirectorySeparatorChar 傳回。

Combine不同於方法，Join方法不會嘗試根目錄傳回的路徑。 (也就是說，如果 path2 或 path3 或 path4 是絕對路徑， Join 則方法不會捨棄先前的路徑，因為 Combine 方法會 )

並非所有目錄和檔名無效的字元都會由 Join 方法解譯為無法接受，因為您可以使用這些字元來搜尋通配符。例如，雖然 Path.Join("c:\\", "temp", "*.txt") 在建立檔案時可能無效，但它在搜尋字串中有效。因此，此方法 Join 已成功解譯。

適用於

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

來源:: Path.cs

來源:: Path.cs

來源:: 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>

包含第四個聯結路徑的字元範圍。

傳回

String

串連的路徑。

備註

如果其中一個路徑元件不存在，這個方法只會串連 path、 path2path3 和，並在path4任一路徑元件之間加入目錄分隔符。 Length如果任何path1、 path2path3 或 path4 自變數的是零，則方法會串連其餘自變數。 ReadOnlySpan<T>.Length如果所有元件的為零，方法會傳String.Empty回。

擷取屬性的值， Path.DirectorySeparatorChar 而不是硬式編碼目錄分隔符。
使用正斜線 (“/”) 做為目錄分隔符。這個字元是由 Path.DirectorySeparatorChar Unix 系統上的屬性和 Windows 系統上的屬性所 Path.AltDirectorySeparatorChar 傳回。

適用於

Join(String, String, String)

來源:: Path.cs

來源:: Path.cs

來源:: 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

第三個聯結路徑。

傳回

String

串連的路徑。

備註

如果其中一個路徑元件不存在，這個方法只會串連 path、 path2和，並在 path3 任一路徑元件之間加入目錄分隔符。如果任何、 path1path2 或 path3 自變數的長度為零，則方法會串連其餘自變數。如果產生的串連字串長度為零，則方法會傳 String.Empty回。

如果 path1 或 path2 結尾為不適合目標平臺的路徑分隔符，則 Join 方法會保留原始路徑分隔符，並附加支援的分隔符。此問題發生在使用 Windows 反斜杠 (“\”) 字元的硬式編碼路徑中，無法辨識為 Unix 系統上的路徑分隔符。若要解決此問題，您可以：

擷取屬性的值， Path.DirectorySeparatorChar 而不是硬式編碼目錄分隔符。
使用正斜線 (“/”) 做為目錄分隔符。這個字元是由 Path.DirectorySeparatorChar Unix 系統上的屬性和 Windows 系統上的屬性所 Path.AltDirectorySeparatorChar 傳回。

Combine不同於方法，Join方法不會嘗試根目錄傳回的路徑。 (也就是說，如果 path2 或 path3 是絕對路徑， Join 則方法不會捨棄先前的路徑，因為 Combine 方法會 )

適用於

Join(String[])

來源:: Path.cs

來源:: Path.cs

來源:: 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[]

路徑陣列。

傳回

String

串連的路徑。

備註

這個方法只會串連中的所有 paths 字串，並在其中一個路徑元件之間加入一個目錄分隔符，如果其中一個尚未存在的話。 Length如果中的任何paths路徑為零，方法會串連其餘自變數。如果產生的串連字串長度為零，則方法會傳 String.Empty回。

如果中 paths有任何路徑，但最後一個路徑除外，則會以不適合目標平臺的路徑分隔符結尾， Join 此方法會保留原始路徑分隔符字元，並附加支援的分隔符。此問題發生在使用 Windows 反斜杠 (“\”) 字元的硬式編碼路徑中，無法辨識為 Unix 系統上的路徑分隔符。若要解決此問題，您可以：

擷取屬性的值， Path.DirectorySeparatorChar 而不是硬式編碼目錄分隔符。
使用正斜線 (“/”) 做為目錄分隔符。這個字元是由 Path.DirectorySeparatorChar Unix 系統上的屬性和 Windows 系統上的屬性所 Path.AltDirectorySeparatorChar 傳回。

Combine不同於方法，Join方法不會嘗試根目錄傳回的路徑。 (也就是說，如果中的 paths任一個路徑除外，第一個路徑是絕對路徑， Join 則方法不會捨棄先前的路徑，因為 Combine 方法會像方法一樣捨棄先前的路徑。)

適用於

Join(String, String)

來源:: Path.cs

來源:: Path.cs

來源:: 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

第二個聯結路徑。

傳回

String

串連的路徑。

備註

如果其中一個路徑元件不存在，這個方法只會串連 path 和， path2 並在任何路徑元件之間新增目錄分隔符。如果或 path2 的path1長度為零，方法會串連其餘自變數。如果產生的串連字串長度為零，則方法會傳 String.Empty回。

如果 path1 結尾為不適合目標平臺的路徑分隔符，則 Join 方法會保留原始路徑分隔符，並附加支援的分隔符。此問題發生在使用 Windows 反斜杠 (“\”) 字元的硬式編碼路徑中，無法辨識為 Unix 系統上的路徑分隔符。若要解決此問題，您可以：

擷取屬性的值， Path.DirectorySeparatorChar 而不是硬式編碼目錄分隔符。
使用正斜線 (“/”) 做為目錄分隔符。這個字元是由 Path.DirectorySeparatorChar Unix 系統上的屬性和 Windows 系統上的屬性所 Path.AltDirectorySeparatorChar 傳回。

Combine不同於方法，Join方法不會嘗試根目錄傳回的路徑。 (也就是說，如果 path2 是絕對路徑， Join 則方法不會捨棄先前的路徑，因為 Combine 方法會 )

適用於

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

來源:: Path.cs

來源:: Path.cs

來源:: 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>

包含第二個聯結路徑的字元範圍。

傳回

String

合併的路徑。

範例

下列範例說明和 Path.Combine(String, String) 方法傳Path.Join(ReadOnlySpan<Char>, ReadOnlySpan<Char>)回的路徑差異。當第一個字串是包含磁碟驅動器和根目錄的完整路徑，而第二個字元串是來自第一個路徑的相對路徑時，這兩種方法會產生相同的結果。在方法的第二和第三個 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/'

備註

如果兩個路徑元件尚未存在path1或開頭path2，這個方法只會串連 path 和 path2 ，並在兩個路徑元件之間加入目錄分隔符。 Length如果或 path2 的 path1 為零，方法會傳回另一個路徑。 Length如果與 path2 的 path1 為零，則方法會傳String.Empty回。

擷取屬性的值， Path.DirectorySeparatorChar 而不是硬式編碼目錄分隔符。
使用正斜線 (“/”) 做為目錄分隔符。這個字元是由 Path.DirectorySeparatorChar Unix 系統上的屬性和 Windows 系統上的屬性所 Path.AltDirectorySeparatorChar 傳回。

Combine不同於方法，Join方法不會嘗試根目錄傳回的路徑。 (也就是說，如果 path2 是絕對路徑，Join則方法不會捨棄並傳path1回，因為Combine方法會 ) 下列範例說明兩種方法所傳回path2路徑的差異。如果的來源 path2 是使用者輸入， Combine 方法可讓使用者存取檔系統資源， (例如 C：/Users/User1/Documents/Financial/ ，在範例中) 應用程式不想要存取。

並非所有目錄和檔名無效的字元都會由 Join 方法解譯為無法接受，因為您可以使用這些字元來搜尋通配符。例如，雖然 Path.Join("c:\\", "*.txt") 在建立檔案時可能無效，但它在搜尋字串中有效。因此，此方法 Join 已成功解譯。

另請參閱

Windows 系統上的檔案路徑格式

適用於

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

來源:: Path.cs

來源:: Path.cs

來源:: 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>

包含第三個聯結路徑的字元範圍。

傳回

String

串連的路徑。

範例

下列範例說明和 Path.Combine(String, String, String) 方法傳Path.Join(ReadOnlySpan<Char>, ReadOnlySpan<Char>, ReadOnlySpan<Char>)回的路徑差異。當第一個字串是包含磁碟驅動器和根目錄的完整路徑，而第二個字元串是來自第一個路徑的相對路徑時，這兩種方法會產生相同的結果。在方法的第二和第三個 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'

備註

如果其中一個路徑元件不存在，這個方法只會串連 path、 path2和，並在 path3 任一路徑元件之間加入目錄分隔符。 Length如果任何path1、 path2或 path3 自變數的是零，則方法會串連其餘自變數。 ReadOnlySpan<T>.Length如果所有元件的為零，方法會傳String.Empty回。

擷取屬性的值， Path.DirectorySeparatorChar 而不是硬式編碼目錄分隔符。
使用正斜線 (“/”) 做為目錄分隔符。這個字元是由 Path.DirectorySeparatorChar Unix 系統上的屬性和 Windows 系統上的屬性所 Path.AltDirectorySeparatorChar 傳回。

另請參閱

Windows 系統上的檔案路徑格式

適用於

Path.Join 方法

定義

多載

Join(String, String, String, String)

參數

傳回

備註

適用於

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

參數

傳回

備註

適用於

Join(String, String, String)

參數

傳回

備註

適用於

Join(String[])

參數

傳回

備註

適用於

Join(String, String)

參數

傳回

備註

適用於

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

參數

傳回

範例

備註

另請參閱

適用於

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

參數

傳回

範例

備註

另請參閱

適用於

意見反應

其他資源