Path.Join Metoda

Definice

Obor názvů:

System.IO

Sestavení:

System.Runtime.dll

Přetížení

Join(String, String, String, String)	Zřetězí čtyři cesty do jedné cesty.
Join(ReadOnlySpan<Char>, ReadOnlySpan<Char>, ReadOnlySpan<Char>, ReadOnlySpan<Char>)	Zřetězí čtyři komponenty cesty do jedné cesty.
Join(String, String, String)	Zřetězí tři cesty do jedné cesty.
Join(String[])	Zřetězí pole cest do jedné cesty.
Join(String, String)	Zřetězí dvě cesty do jedné cesty.
Join(ReadOnlySpan<Char>, ReadOnlySpan<Char>)	Zřetězí dvě komponenty cesty do jedné cesty.
Join(ReadOnlySpan<Char>, ReadOnlySpan<Char>, ReadOnlySpan<Char>)	Zřetězí tři komponenty cesty do jedné cesty.

Join(String, String, String, String)

Zdroj:

Path.cs

Zřetězí čtyři cesty do jedné cesty.

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

Parametry

path1

String

První cesta pro připojení.

path2

String

Druhá cesta pro připojení.

path3

String

Třetí cesta pro připojení.

path4

String

Čtvrtá cesta ke spojení.

Návraty

String

Zřetězená cesta.

Poznámky

Tato metoda jednoduše zřetězí path, path3path2a path4 přidá znak oddělovače adresáře mezi libovolnou komponentu cesty, pokud ještě neexistuje. Pokud je délka některého z argumentů path1, path2path3 nebo path4 nulová, metoda zřetězí zbývající argumenty. Pokud je délka výsledného zřetězeného řetězce nula, vrátí String.Emptymetoda .

Pokud path1 nebo path2 končí path3 znak oddělovače cesty, který není vhodný pro cílovou platformu Join , metoda zachová původní znak oddělovače cesty a připojí podporovaný znak. K tomuto problému dochází v pevně zakódovaných cestách, které používají znak zpětného lomítka systému Windows ("\"), který není rozpoznán jako oddělovač cesty v systémech Unix. Pokud chcete tento problém obejít, můžete:

• Načtěte hodnotu Path.DirectorySeparatorChar vlastnosti místo pevného kódování znaku oddělovače adresáře.

• Jako znak oddělovače adresáře použijte lomítko ("/"). Tento znak je vrácen Path.DirectorySeparatorChar vlastností v systémech Unix a vlastností v Path.AltDirectorySeparatorChar systémech Windows.

Combine Na rozdíl od metody se Join metoda nepokoušá o kořen vrácenou cestu. (To znamená, že pokud path2 nebo path3 nebo path4 je absolutní cesta, Join metoda nezahodí předchozí cesty jako Combine metoda.)

Ne všechny neplatné znaky pro názvy adresářů a souborů jsou interpretovány jako nepřijatelné metodou Join , protože tyto znaky můžete použít pro vyhledávání zástupných znaků. I když Path.Join("c:\\", "temp", "*.txt") může být například při vytváření souboru neplatný, je platný jako hledaný řetězec. Metoda Join ho proto úspěšně interpretuje.

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

Zdroj:

Path.cs

Zřetězí čtyři komponenty cesty do jedné cesty.

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

Parametry

path1

ReadOnlySpan<Char>

Rozsah znaků, který obsahuje první cestu ke spojení.

path2

ReadOnlySpan<Char>

Rozsah znaků, který obsahuje druhou cestu, která se má spojit.

path3

ReadOnlySpan<Char>

Znakový rozsah, který obsahuje třetí cestu, která se má spojit.

path4

ReadOnlySpan<Char>

Rozsah znaků, který obsahuje čtvrtou cestu, která se má spojit.

Návraty

String

Zřetězená cesta.

Poznámky

Tato metoda jednoduše zřetězí path, path3path2a path4 přidá znak oddělovače adresáře mezi libovolnou komponentu cesty, pokud ještě neexistuje. Length Pokud je hodnota některého z argumentů path1, path2path3 nebo path4 nulová, metoda zřetězí zbývající argumenty. Pokud je hodnota ReadOnlySpan<T>.Length všech komponent nula, vrátí String.Emptymetoda hodnotu .

Pokud path1 nebo path2 končí path3 znak oddělovače cesty, který není vhodný pro cílovou platformu Join , metoda zachová původní znak oddělovače cesty a připojí podporovaný znak. K tomuto problému dochází v pevně zakódovaných cestách, které používají znak zpětného lomítka systému Windows ("\"), který není rozpoznán jako oddělovač cesty v systémech Unix. Pokud chcete tento problém obejít, můžete:

• Načtěte hodnotu Path.DirectorySeparatorChar vlastnosti místo pevného kódování znaku oddělovače adresáře.

• Jako znak oddělovače adresáře použijte lomítko ("/"). Tento znak je vrácen Path.DirectorySeparatorChar vlastností v systémech Unix a vlastností v Path.AltDirectorySeparatorChar systémech Windows.

Combine Na rozdíl od metody se Join metoda nepokoušá o kořen vrácenou cestu. (To znamená, že pokud path2 nebo path3 nebo path4 je absolutní cesta, Join metoda nezahodí předchozí cesty jako Combine metoda.)

Ne všechny neplatné znaky pro názvy adresářů a souborů jsou interpretovány jako nepřijatelné metodou Join , protože tyto znaky můžete použít pro vyhledávání zástupných znaků. I když Path.Join("c:\\", "temp", "*.txt") může být například při vytváření souboru neplatný, je platný jako hledaný řetězec. Metoda Join ho proto úspěšně interpretuje.

Join(String, String, String)

Zdroj:

Path.cs

Zřetězí tři cesty do jedné cesty.

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

Parametry

path1

String

První cesta pro připojení.

path2

String

Druhá cesta pro připojení.

path3

String

Třetí cesta pro připojení.

Návraty

String

Zřetězená cesta.

Poznámky

Tato metoda jednoduše zřetězí path, path2a path3 přidá znak oddělovače adresáře mezi libovolnou komponentu cesty, pokud ještě neexistuje. Pokud je délka některého argumentu path1nebo path3path2 nula, metoda zřetězí zbývající argumenty. Pokud je délka výsledného zřetězeného řetězce nula, vrátí String.Emptymetoda .

Pokud path1 nebo path2 končí znak oddělovače cesty, který není vhodný pro cílovou platformu Join , metoda zachová původní znak oddělovače cesty a připojí podporovaný znak. K tomuto problému dochází v pevně zakódovaných cestách, které používají znak zpětného lomítka systému Windows ("\"), který není rozpoznán jako oddělovač cesty v systémech Unix. Pokud chcete tento problém obejít, můžete:

• Načtěte hodnotu Path.DirectorySeparatorChar vlastnosti místo pevného kódování znaku oddělovače adresáře.

• Jako znak oddělovače adresáře použijte lomítko ("/"). Tento znak je vrácen Path.DirectorySeparatorChar vlastností v systémech Unix a vlastností v Path.AltDirectorySeparatorChar systémech Windows.

Combine Na rozdíl od metody se Join metoda nepokoušá o kořen vrácenou cestu. (To znamená, že pokud path2 nebo path3 je absolutní cesta, Join metoda nezahodí předchozí cesty jako Combine metoda.)

Ne všechny neplatné znaky pro názvy adresářů a souborů jsou interpretovány jako nepřijatelné metodou Join , protože tyto znaky můžete použít pro vyhledávání zástupných znaků. I když Path.Join("c:\\", "temp", "*.txt") může být například při vytváření souboru neplatný, je platný jako hledaný řetězec. Metoda Join ho proto úspěšně interpretuje.

Join(String[])

Zdroj:

Path.cs

Zřetězí pole cest do jedné cesty.

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

Parametry

paths

String[]

Pole cest.

Návraty

String

Zřetězená cesta.

Poznámky

Tato metoda jednoduše zřetězí všechny řetězce v paths a přidá znak oddělovače adresáře mezi libovolnou komponentu cesty, pokud ještě neexistuje. Length Pokud je hodnota některé z cest v paths nule, metoda zřetězí zbývající argumenty. Pokud je délka výsledného zřetězení řetězce nulová, vrátí String.Emptymetoda .

Pokud některá z cest v pathsobjektu s výjimkou poslední končí znakem oddělovače cesty, který není vhodný pro cílovou platformu Join , zachová metoda původní znak oddělovače cesty a připojí podporovaný znak. K tomuto problému dochází v pevně zakódovaných cestách, které používají znak zpětného lomítka systému Windows ("\"), který není rozpoznán jako oddělovač cesty v systémech Unix. Pokud chcete tento problém obejít, můžete:

• Načtěte hodnotu Path.DirectorySeparatorChar vlastnosti místo pevného kódování znaku oddělovače adresáře.

• Jako znak oddělovače adresáře použijte lomítko ("/"). Tento znak je vrácen Path.DirectorySeparatorChar vlastností v systémech Unix a vlastností v Path.AltDirectorySeparatorChar systémech Windows.

Combine Na rozdíl od metody se Join metoda nepokoušá o kořen vrácenou cestu. (To znamená, že pokud je některá z cest v pathsobjektu s výjimkou první cesty absolutní cestou, Join metoda nezahodí předchozí cesty jako Combine metoda.)

Ne všechny neplatné znaky pro názvy adresářů a souborů jsou interpretovány jako nepřijatelné metodou Join , protože tyto znaky můžete použít pro vyhledávání zástupných znaků. I když Path.Join("c:\\", "temp", "*.txt") může být například při vytváření souboru neplatný, je platný jako hledaný řetězec. Metoda Join ho proto úspěšně interpretuje.

Join(String, String)

Zdroj:

Path.cs

Zřetězí dvě cesty do jedné cesty.

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

Parametry

path1

String

První cesta pro připojení.

path2

String

Druhá cesta pro připojení.

Návraty

String

Zřetězená cesta.

Poznámky

Tato metoda jednoduše zřetězí path a path2 přidá znak oddělovače adresáře mezi libovolnou komponentu cesty, pokud ještě neexistuje. Pokud je délka nebo path1path2 nula, metoda zřetězí zbývající argument. Pokud je délka výsledného zřetězeného řetězce nula, vrátí String.Emptymetoda .

Pokud path1 končí znak oddělovače cesty, který není vhodný pro cílovou platformu Join , metoda zachová původní znak oddělovače cesty a připojí podporovaný znak. K tomuto problému dochází v pevně zakódovaných cestách, které používají znak zpětného lomítka systému Windows ("\"), který není rozpoznán jako oddělovač cesty v systémech Unix. Pokud chcete tento problém obejít, můžete:

• Načtěte hodnotu Path.DirectorySeparatorChar vlastnosti místo pevného kódování znaku oddělovače adresáře.

• Jako znak oddělovače adresáře použijte lomítko ("/"). Tento znak je vrácen Path.DirectorySeparatorChar vlastností v systémech Unix a vlastností v Path.AltDirectorySeparatorChar systémech Windows.

Combine Na rozdíl od metody se Join metoda nepokoušá o kořen vrácenou cestu. (To znamená, že pokud path2 je absolutní cesta, Join metoda nezahodí předchozí cesty jako Combine metoda.)

Ne všechny neplatné znaky pro názvy adresářů a souborů jsou interpretovány jako nepřijatelné metodou Join , protože tyto znaky můžete použít pro vyhledávání zástupných znaků. I když Path.Join("c:\\", "temp", "*.txt") může být například při vytváření souboru neplatný, je platný jako hledaný řetězec. Metoda Join ho proto úspěšně interpretuje.

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

Zdroj:

Path.cs

Zřetězí dvě komponenty cesty do jedné cesty.

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

Parametry

path1

ReadOnlySpan<Char>

Rozsah znaků, který obsahuje první cestu ke spojení.

path2

ReadOnlySpan<Char>

Rozsah znaků, který obsahuje druhou cestu, která se má spojit.

Návraty

String

Kombinované cesty.

Příklady

Následující příklad znázorňuje rozdíl v cestách vrácených metodami Path.Join(ReadOnlySpan<Char>, ReadOnlySpan<Char>) a Path.Combine(String, String) . Pokud je první řetězec plně kvalifikovanou cestou, která obsahuje jednotku a kořenový adresář a druhý je relativní cestou z první cesty, tyto dvě metody generují stejné výsledky. Ve druhém a třetím volání metody se ShowPathInformation řetězce vrácené dvěma metodami liší. Ve druhém volání metody je prvním řetězcovým argumentem jednotka, zatímco druhý je kořenový adresář. Metoda Join zřetězí dva řetězce a zachová duplicitní oddělovače cest. Metoda Combine opustí jednotku a vrátí kořenový adresář na aktuální jednotce. Pokud je aktuální jednotka aplikace C:\ a řetězec se používá pro přístup k souboru nebo souborům v adresáři, bude přistupovat k C: místo D:. Vzhledem k ShowPathInformation tomu, že oba argumenty ve třetím volání jsou rootované, Join metoda je jednoduše připojí k vytvoření nesmyslné cesty k souboru, zatímco Combine metoda zahodí první řetězec a vrátí druhý. Použití tohoto řetězce pro přístup k souborům může aplikaci poskytnout nezamýšlený přístup k citlivým souborům.

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/'

Poznámky

Tato metoda jednoduše zřetězí path a path2 přidá znak oddělovače adresáře mezi dvě komponenty cesty, pokud již není na konci path1 nebo začátku path2. Pokud je Length hodnota nebo path1path2 nula, vrátí metoda druhou cestu. Pokud je hodnota Length a path1path2 nula, vrátí String.Emptymetoda hodnotu .

Pokud path1 končí znak oddělovače cesty, který není vhodný pro cílovou platformu Join , metoda zachová původní znak oddělovače cesty a připojí podporovaný znak. K tomuto problému dochází v pevně zakódovaných cestách, které používají znak zpětného lomítka systému Windows ("\"), který není rozpoznán jako oddělovač cesty v systémech Unix. Pokud chcete tento problém obejít, můžete:

• Načtěte hodnotu Path.DirectorySeparatorChar vlastnosti místo pevného kódování znaku oddělovače adresáře.

• Jako znak oddělovače adresáře použijte lomítko ("/"). Tento znak je vrácen Path.DirectorySeparatorChar vlastností v systémech Unix a vlastností v Path.AltDirectorySeparatorChar systémech Windows.

Combine Na rozdíl od metody se Join metoda nepokoušá o kořen vrácenou cestu. (To znamená, že pokud path2 je absolutní cesta, Join metoda nezahodí path1 a nevrací path2 jako Combine metoda.) Následující příklad znázorňuje rozdíl v cestách vrácených dvěma metodami. Pokud je zdrojem path2 vstup uživatele, Combine metoda umožňuje uživateli přístup k prostředku systému souborů (například C:/Users/User1/Documents/Financial/ v případě příkladu), který aplikace nechtěla zpřístupnit.

Ne všechny neplatné znaky pro názvy adresářů a souborů jsou interpretovány jako nepřijatelné metodou Join , protože tyto znaky můžete použít pro vyhledávání zástupných znaků. I když Path.Join("c:\\", "*.txt") může být například při vytváření souboru neplatný, je platný jako hledaný řetězec. Metoda Join ho proto úspěšně interpretuje.

Viz také

• Formáty cesty k souborům v systémech Windows

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

Zdroj:

Path.cs

Zřetězí tři komponenty cesty do jedné cesty.

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

Parametry

path1

ReadOnlySpan<Char>

Rozsah znaků, který obsahuje první cestu ke spojení.

path2

ReadOnlySpan<Char>

Rozsah znaků, který obsahuje druhou cestu, která se má spojit.

path3

ReadOnlySpan<Char>

Znakový rozsah, který obsahuje třetí cestu, která se má spojit.

Návraty

String

Zřetězená cesta.

Příklady

Následující příklad znázorňuje rozdíl v cestách vrácených metodami Path.Join(ReadOnlySpan<Char>, ReadOnlySpan<Char>, ReadOnlySpan<Char>) a Path.Combine(String, String, String) . Pokud je první řetězec plně kvalifikovanou cestou, která obsahuje jednotku a kořenový adresář a druhý je relativní cestou z první cesty, tyto dvě metody generují stejné výsledky. Ve druhém a třetím volání metody se ShowPathInformation řetězce vrácené dvěma metodami liší. Ve druhém volání metody je prvním řetězcovým argumentem jednotka, zatímco druhý je kořenový adresář. Metoda Join zřetězí dva řetězce a zachová duplicitní oddělovače cest. Volání GetFullPath metody by vyloučilo duplikaci. Metoda Combine opustí jednotku a vrátí kořenový adresář na aktuální jednotce. Pokud je aktuální jednotka aplikace C:\ a řetězec se používá pro přístup k souboru nebo souborům v adresáři, bude přistupovat k C: místo D:. Nakonec, protože poslední argument ve třetím volání ShowPathInformation je root, Join metoda jednoduše připojí k prvním dvěma argumentům a vytvoří nesmyslnou cestu k souboru, zatímco Combine metoda zahodí první dva řetězce a vrátí třetí. Použití tohoto řetězce pro přístup k souborům může aplikaci poskytnout nezamýšlený přístup k citlivým souborům.

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'

Poznámky

Tato metoda jednoduše zřetězí path, path2a path3 přidá znak oddělovače adresáře mezi libovolnou komponentu cesty, pokud ještě neexistuje. Length Pokud je hodnota některého z argumentů path1, path2nebo path3 nulová, metoda zřetězí zbývající argumenty. Pokud je hodnota ReadOnlySpan<T>.Length všech komponent nula, vrátí String.Emptymetoda hodnotu .

Pokud path1 nebo path2 končí znak oddělovače cesty, který není vhodný pro cílovou platformu Join , metoda zachová původní znak oddělovače cesty a připojí podporovaný znak. K tomuto problému dochází v pevně zakódovaných cestách, které používají znak zpětného lomítka systému Windows ("\"), který není rozpoznán jako oddělovač cesty v systémech Unix. Pokud chcete tento problém obejít, můžete:

• Načtěte hodnotu Path.DirectorySeparatorChar vlastnosti místo pevného kódování znaku oddělovače adresáře.

• Jako znak oddělovače adresáře použijte lomítko ("/"). Tento znak je vrácen Path.DirectorySeparatorChar vlastností v systémech Unix a vlastností v Path.AltDirectorySeparatorChar systémech Windows.

Combine Na rozdíl od metody se Join metoda nepokoušá o kořen vrácenou cestu. (To znamená, že pokud path2 nebo path3 je absolutní cesta, Join metoda nezahodí předchozí cesty jako Combine metoda.)

Ne všechny neplatné znaky pro názvy adresářů a souborů jsou interpretovány jako nepřijatelné metodou Join , protože tyto znaky můžete použít pro vyhledávání zástupných znaků. I když Path.Join("c:\\", "temp", "*.txt") může být například při vytváření souboru neplatný, je platný jako hledaný řetězec. Metoda Join ho proto úspěšně interpretuje.

Viz také

• Formáty cesty k souborům v systémech Windows