Path.Combine Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Kombiniert Zeichenfolgen zu einem Pfad.
Überlädt
Combine(String[]) |
Kombiniert ein Array von Zeichenfolgen zu einem Pfad. |
Combine(String, String) |
Kombiniert zwei Zeichenfolgen zu einem Pfad. |
Combine(String, String, String) |
Kombiniert drei Zeichenfolgen zu einem Pfad. |
Combine(String, String, String, String) |
Kombiniert vier Zeichenfolgen zu einem Pfad. |
Hinweise
Diese Methode soll einzelne Zeichenfolgen zu einer einzelnen Zeichenfolge verketten, die einen Dateipfad darstellt. Wenn jedoch ein anderes Argument als das erste einen rootenden Pfad enthält, werden alle vorherigen Pfadkomponenten ignoriert, und die zurückgegebene Zeichenfolge beginnt mit dieser Rootpfadkomponente. Alternativ zur Combine
-Methode sollten Sie die Join -Methode oder TryJoin verwenden.
Wichtig
Bei dieser Methode wird davon ausgegangen, dass das erste Argument ein absoluter Pfad ist und dass die folgenden Argumente relative Pfade sind. Wenn dies nicht der Fall ist, und insbesondere, wenn nachfolgende Argumente Zeichenfolgen sind, die vom Benutzer eingegeben werden, rufen Sie stattdessen die Join - oder TryJoin -Methode auf.
Combine(String[])
Kombiniert ein Array von Zeichenfolgen zu einem Pfad.
public:
static System::String ^ Combine(... cli::array <System::String ^> ^ paths);
public static string Combine (params string[] paths);
static member Combine : string[] -> string
Public Shared Function Combine (ParamArray paths As String()) As String
Parameter
- paths
- String[]
Ein Array der Teile des Pfads.
Gibt zurück
Die kombinierten Pfade.
Ausnahmen
.NET Framework und .NET Core-Versionen älter als 2.1: Eine der Zeichenfolgen im Array enthält mindestens ein ungültiges Zeichen, das in GetInvalidPathChars()definiert ist.
Eine der Zeichenfolgen im Array ist null
.
Beispiele
Im folgenden Beispiel wird ein Array von Zeichenfolgen zu einem Pfad kombiniert.
string[] paths = {@"d:\archives", "2001", "media", "images"};
string fullPath = Path.Combine(paths);
Console.WriteLine(fullPath);
Dim paths As String() = {"d:\archives", "2001", "media", "images"}
Dim fullPath As String = Path.Combine(paths)
Console.WriteLine(fullPath)
Hinweise
paths
sollte ein Array der zu kombinierenden Teile des Pfads sein. Wenn der eine der nachfolgenden Pfade ein absoluter Pfad ist, wird der Kombinationsvorgang ab diesem absoluten Pfad zurückgesetzt, wobei alle vorherigen kombinierten Pfade verworfen werden.
Wenn ein Element in paths
, aber das letzte Element kein Laufwerk ist und weder mit dem DirectorySeparatorChar - noch mit dem AltDirectorySeparatorChar -Zeichen endet, fügt die Combine
-Methode ein Zeichen zwischen diesem Element und dem nächsten Element hinzu DirectorySeparatorChar . Wenn das Element mit einem Pfadtrennzeichen endet, das nicht für die Zielplattform geeignet ist, behält die Combine
Methode das ursprüngliche Pfadtrennzeichen bei und fügt ein unterstütztes an. Im folgenden Beispiel wird das Ergebnis auf Windows- und Unix-basierten Systemen verglichen, wenn der umgekehrte Schrägstrich als Pfadtrennzeichen verwendet wird.
string[] paths = {@"d:\archives", "2001", "media", "images"};
string fullPath = Path.Combine(paths);
Console.WriteLine(fullPath);
paths = new string[] {@"d:\archives\", @"2001\", "media", "images"};
fullPath = Path.Combine(paths);
Console.WriteLine(fullPath);
paths = new string[] {"d:/archives/", "2001/", "media", "images"};
fullPath = Path.Combine(paths);
Console.WriteLine(fullPath);
// The example displays the following output if run on a Windows system:
// d:\archives\2001\media\images
// d:\archives\2001\media\images
// d:/archives/2001/media\images
//
// The example displays the following output if run on a Unix-based system:
// d:\archives/2001/media/images
// d:\archives\/2001\/media/images
// d:/archives/2001/media/images
Dim paths As String() = { "d:\archives", "2001", "media", "images" }
Dim fullPath As String = Path.Combine(paths)
Console.WriteLine(fullPath)
paths = { "d:\archives\", "2001\", "media", "images" }
fullPath = Path.Combine(paths)
Console.WriteLine(fullPath)
paths = { "d:/archives/", "2001/", "media", "images" }
fullPath = Path.Combine(paths)
Console.WriteLine(fullPath)
' The example displays the following output if run on a Windows system:
' d:\archives\2001\media\images
' d:\archives\2001\media\images
' d:/archives/2001/media\images
'
' The example displays the following output if run on a Linux system:
' d:\archives/2001/media/images
' d:\archives\/2001\/media/images
' d:/archives/2001/media/images
Zeichenfolgen der Länge null werden aus dem kombinierten Pfad weggelassen.
Die Parameter werden nicht analysiert, wenn sie Leerraum haben.
.NET Framework- und .NET Core-Versionen älter als 2.1: Nicht alle ungültigen Zeichen für Verzeichnis- und Dateinamen werden von der Combine
Methode als inakzeptabel interpretiert, da Sie diese Zeichen für Suchplatzhalterzeichen verwenden können. Wenn Sie beispielsweise Path.Combine("c:\\", "*.txt")
eine Datei daraus erstellen, ist sie zwar ungültig, aber sie ist als Suchzeichenfolge gültig. Sie wird daher von der Combine
-Methode erfolgreich interpretiert.
Weitere Informationen
Gilt für:
Combine(String, String)
Kombiniert zwei Zeichenfolgen zu einem Pfad.
public:
static System::String ^ Combine(System::String ^ path1, System::String ^ path2);
public static string Combine (string path1, string path2);
static member Combine : string * string -> string
Public Shared Function Combine (path1 As String, path2 As String) As String
Parameter
- path1
- String
Der erste zu kombinierende Pfad.
- path2
- String
Der zweite zu kombinierende Pfad.
Gibt zurück
Die kombinierten Pfade. Wenn einer der beiden angegebenen Pfade eine Zeichenfolge der Länge 0 ist, gibt diese Methode den anderen Pfad zurück. Wenn path2
einen absoluten Pfad enthält, gibt diese Methode path2
zurück.
Ausnahmen
.NET Framework- und .NET Core-Versionen älter als 2.1: path1
oder path2
enthält mindestens eins der ungültigen Zeichen, die in GetInvalidPathChars()definiert sind.
path1
oder path2
ist null
.
Beispiele
Im folgenden Beispiel wird die Verwendung der Combine
-Methode unter Windows veranschaulicht.
using namespace System;
using namespace System::IO;
void CombinePaths( String^ p1, String^ p2 )
{
try
{
String^ combination = Path::Combine( p1, p2 );
Console::WriteLine( "When you combine '{0}' and '{1}', the result is: {2}'{3}'", p1, p2, Environment::NewLine, combination );
}
catch ( Exception^ e )
{
if (p1 == nullptr)
p1 = "nullptr";
if (p2 == nullptr)
p2 = "nullptr";
Console::WriteLine( "You cannot combine '{0}' and '{1}' because: {2}{3}", p1, p2, Environment::NewLine, e->Message );
}
Console::WriteLine();
}
int main()
{
String^ path1 = "c:\\temp";
String^ path2 = "subdir\\file.txt";
String^ path3 = "c:\\temp.txt";
String^ path4 = "c:^*&)(_=@#'\\^.*(.txt";
String^ path5 = "";
String^ path6 = nullptr;
CombinePaths( path1, path2 );
CombinePaths( path1, path3 );
CombinePaths( path3, path2 );
CombinePaths( path4, path2 );
CombinePaths( path5, path2 );
CombinePaths( path6, path2 );
}
using System;
using System.IO;
public class ChangeExtensionTest
{
public static void Main()
{
string path1 = "c:\\temp";
string path2 = "subdir\\file.txt";
string path3 = "c:\\temp.txt";
string path4 = "c:^*&)(_=@#'\\^.*(.txt";
string path5 = "";
CombinePaths(path1, path2);
CombinePaths(path1, path3);
CombinePaths(path3, path2);
CombinePaths(path4, path2);
CombinePaths(path5, path2);
}
private static void CombinePaths(string p1, string p2)
{
string combination = Path.Combine(p1, p2);
Console.WriteLine("When you combine '{0}' and '{1}', the result is: {2}'{3}'",
p1, p2, Environment.NewLine, combination);
Console.WriteLine();
}
}
// This code produces output similar to the following:
//
// When you combine 'c:\temp' and 'subdir\file.txt', the result is:
// 'c:\temp\subdir\file.txt'
//
// When you combine 'c:\temp' and 'c:\temp.txt', the result is:
// 'c:\temp.txt'
//
// When you combine 'c:\temp.txt' and 'subdir\file.txt', the result is:
// 'c:\temp.txt\subdir\file.txt'
//
// When you combine 'c:^*&)(_=@#'\^.*(.txt' and 'subdir\file.txt', the result is:
// 'c:^*&)(_=@#'\^.*(.txt\subdir\file.txt'
//
// When you combine '' and 'subdir\file.txt', the result is:
// 'subdir\file.txt'
Imports System.IO
Public Class ChangeExtensionTest
Public Shared Sub Main()
Dim path1 As String = "c:\temp"
Dim path2 As String = "subdir\file.txt"
Dim path3 As String = "c:\temp.txt"
Dim path4 As String = "c:^*&)(_=@#'\\^.*(.txt"
Dim path5 As String = ""
Dim path6 As String = Nothing
CombinePaths(path1, path2)
CombinePaths(path1, path3)
CombinePaths(path3, path2)
CombinePaths(path4, path2)
CombinePaths(path5, path2)
CombinePaths(path6, path2)
End Sub
Private Shared Sub CombinePaths(p1 As String, p2 As String)
Try
Dim combination As String = Path.Combine(p1, p2)
Console.WriteLine("When you combine '{0}' and '{1}', the result is: {2}'{3}'", p1, p2, Environment.NewLine, combination)
Catch e As Exception
If p1 = Nothing Then
p1 = "Nothing"
End If
If p2 = Nothing Then
p2 = "Nothing"
End If
Console.WriteLine("You cannot combine '{0}' and '{1}' because: {2}{3}", p1, p2, Environment.NewLine, e.Message)
End Try
Console.WriteLine()
End Sub
End Class
' This code produces output similar to the following:
'
' When you combine 'c:\temp' and 'subdir\file.txt', the result is:
' 'c:\temp\subdir\file.txt'
'
' When you combine 'c:\temp' and 'c:\temp.txt', the result is:
' 'c:\temp.txt'
'
' When you combine 'c:\temp.txt' and 'subdir\file.txt', the result is:
' 'c:\temp.txt\subdir\file.txt'
'
' When you combine 'c:^*&)(_=@#'\^.*(.txt' and 'subdir\file.txt', the result is:
' 'c:^*&)(_=@#'\^.*(.txt\subdir\file.txt'
'
' When you combine '' and 'subdir\file.txt', the result is:
' 'subdir\file.txt'
'
' You cannot combine '' and 'subdir\file.txt' because:
' Value cannot be null.
' Parameter name: path1
Hinweise
Wenn path1
kein Laufwerkverweis (d.h. "C:" oder "D:") ist und nicht mit einem gültigen Trennzeichen endet, wie in DirectorySeparatorChar, VolumeSeparatorCharAltDirectorySeparatorCharoder definiert, DirectorySeparatorChar wird vor der Verkettung an angefügtpath1
. Beachten Sie, dass die Methode das ursprüngliche Pfadtrennzeichen behält, wenn path1
sie mit einem Pfadtrennzeichen endet, Combine
das nicht für die Zielplattform geeignet ist. Im folgenden Beispiel wird das Ergebnis auf Windows- und Unix-basierten Systemen verglichen, wenn der umgekehrte Schrägstrich als Pfadtrennzeichen verwendet wird.
var result = Path.Combine(@"C:\Pictures\", "Saved Pictures");
Console.WriteLine(result);
// The example displays the following output if run on a Windows system:
// C:\Pictures\Saved Pictures
//
// The example displays the following output if run on a Unix-based system:
// C:\Pictures\/Saved Pictures
Dim result = Path.Combine("C:\Pictures\", "Saved Pictures")
Console.WriteLine(result)
' The example displays the following output if run on a Windows system:
' C:\Pictures\Saved Pictures
'
' The example displays the following output if run on a Unix-based system:
' C:\Pictures\/Saved Pictures
Wenn path2
kein Stamm vorhanden ist (z. B. wenn path2
nicht mit einem Trennzeichen oder einer Laufwerksspezifikation gestartet wird), ist das Ergebnis eine Verkettung der beiden Pfade mit einem dazwischen liegenden Trennzeichen. Wenn path2
einen Stamm enthält, path2
wird zurückgegeben.
Die Parameter werden nicht analysiert, wenn sie Leerraum haben. path2
Wenn daher Leerzeichen enthält (z. B. " \file.txt "), wird path2
die Combine -Methode an angefügt, path1
anstatt nur path2
zurückzugeben.
.NET Framework- und .NET Core-Versionen älter als 2.1: Nicht alle ungültigen Zeichen für Verzeichnis- und Dateinamen werden von der Combine
Methode als inakzeptabel interpretiert, da Sie diese Zeichen für Suchplatzhalterzeichen verwenden können. Wenn Sie beispielsweise Path.Combine("c:\\", "*.txt")
eine Datei daraus erstellen, ist sie zwar ungültig, aber sie ist als Suchzeichenfolge gültig. Sie wird daher von der Combine
-Methode erfolgreich interpretiert.
Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.
Weitere Informationen
- Formate von Dateipfaden unter Windows-Systemen
- Datei- und Stream-E/A
- How to: Lesen von Text aus einer Datei
- How to: Schreiben von Text in eine Datei
Gilt für:
Combine(String, String, String)
Kombiniert drei Zeichenfolgen zu einem Pfad.
public:
static System::String ^ Combine(System::String ^ path1, System::String ^ path2, System::String ^ path3);
public static string Combine (string path1, string path2, string path3);
static member Combine : string * string * string -> string
Public Shared Function Combine (path1 As String, path2 As String, path3 As String) As String
Parameter
- path1
- String
Der erste zu kombinierende Pfad.
- path2
- String
Der zweite zu kombinierende Pfad.
- path3
- String
Der dritte zu kombinierende Pfad.
Gibt zurück
Die kombinierten Pfade.
Ausnahmen
.NET Framework- und .NET Core-Versionen älter als 2.1: path1
, path2
oder path3
enthält mindestens eins der ungültigen Zeichen, die in GetInvalidPathChars()definiert sind.
path1
, path2
oder path3
ist null
.
Beispiele
Im folgenden Beispiel werden drei Pfade kombiniert.
string p1 = @"d:\archives\";
string p2 = "media";
string p3 = "images";
string combined = Path.Combine(p1, p2, p3);
Console.WriteLine(combined);
Dim p1 As String = "d:\archives\"
Dim p2 As String = "media"
Dim p3 As String = "images"
Dim combined As String = Path.Combine(p1, p2, p3)
Console.WriteLine(combined)
Hinweise
path1
sollte ein absoluter Pfad sein (z. B. "d:\archives" oder "\\archives\public"). Wenn path2
oder path3
auch ein absoluter Pfad ist, verwirft der Kombinationsvorgang alle zuvor kombinierten Pfade und setzt auf diesen absoluten Pfad zurück.
Zeichenfolgen der Länge null werden aus dem kombinierten Pfad weggelassen.
Wenn path1
oder path2
kein Laufwerkverweis (d.h. "C:" oder "D:") ist und nicht mit einem gültigen Trennzeichen endet, wie in DirectorySeparatorChardefiniert, AltDirectorySeparatorCharoder VolumeSeparatorChar, DirectorySeparatorChar wird an path1
oder path2
vor der Verkettung angefügt. Beachten Sie, dass die Methode das ursprüngliche Pfadtrennzeichen behält, wenn path1
oder path2
in einem Pfadtrennzeichen endet, das für die Zielplattform nicht geeignet ist, Combine
das ursprüngliche Pfadtrennzeichen und fügt ein unterstütztes an. Im folgenden Beispiel wird das Ergebnis auf Windows- und Unix-basierten Systemen verglichen, wenn der umgekehrte Schrägstrich als Pfadtrennzeichen verwendet wird.
var result = Path.Combine(@"C:\Pictures\", @"Saved Pictures\", "2019");
Console.WriteLine(result);
// The example displays the following output if run on a Windows system:
// C:\Pictures\Saved Pictures\2019
//
// The example displays the following output if run on a Unix-based system:
// C:\Pictures\/Saved Pictures\/2019
Dim result = Path.Combine("C:\Pictures\", "Saved Pictures\", "2019")
Console.WriteLine(result)
' The example displays the following output if run on a Windows system:
' C:\Pictures\Saved Pictures\2019
'
' The example displays the following output if run on a Unix-based system:
' C:\Pictures\/Saved Pictures\/2019
Wenn path2
kein Stamm vorhanden ist (z. B. wenn path2
nicht mit einem Trennzeichen oder einer Laufwerksspezifikation gestartet wird), ist das Ergebnis eine Verkettung der beiden Pfade mit einem dazwischen liegenden Trennzeichen. Wenn path2
einen Stamm enthält, path2
wird zurückgegeben.
Die Parameter werden nicht analysiert, wenn sie Leerraum haben. path2
Wenn daher Leerzeichen enthält (z. B. " \file.txt "), wird path2
die Combine -Methode an path1
angefügt.
.NET Framework- und .NET Core-Versionen älter als 2.1: Nicht alle ungültigen Zeichen für Verzeichnis- und Dateinamen werden von der Combine
Methode als inakzeptabel interpretiert, da Sie diese Zeichen für Suchplatzhalterzeichen verwenden können. Wenn Sie beispielsweise Path.Combine("c:\\", "*.txt")
eine Datei daraus erstellen, ist sie zwar ungültig, aber sie ist als Suchzeichenfolge gültig. Sie wird daher von der Combine
-Methode erfolgreich interpretiert.
Weitere Informationen
Gilt für:
Combine(String, String, String, String)
Kombiniert vier Zeichenfolgen zu einem Pfad.
public:
static System::String ^ Combine(System::String ^ path1, System::String ^ path2, System::String ^ path3, System::String ^ path4);
public static string Combine (string path1, string path2, string path3, string path4);
static member Combine : string * string * string * string -> string
Public Shared Function Combine (path1 As String, path2 As String, path3 As String, path4 As String) As String
Parameter
- path1
- String
Der erste zu kombinierende Pfad.
- path2
- String
Der zweite zu kombinierende Pfad.
- path3
- String
Der dritte zu kombinierende Pfad.
- path4
- String
Der vierte zu kombinierende Pfad.
Gibt zurück
Die kombinierten Pfade.
Ausnahmen
.NET Framework und .NET Core-Versionen älter als 2.1: path1
, path2
, path3
oder path4
enthält mindestens eins der ungültigen Zeichen, die in GetInvalidPathChars()definiert sind.
path1
, path2
, path3
oder path4
ist null
.
Beispiele
Im folgenden Beispiel werden vier Pfade kombiniert.
string path1 = @"d:\archives\";
string path2 = "2001";
string path3 = "media";
string path4 = "images";
string combinedPath = Path.Combine(path1, path2, path3, path4);
Console.WriteLine(combinedPath);
Dim path1 As String = "d:\archives\"
Dim path2 As String = "2001"
Dim path3 As String = "media"
Dim path4 As String = "imaged"
Dim combinedPath As String = Path.Combine(path1, path2, path3, path4)
Console.WriteLine(combined)
Hinweise
path1
sollte ein absoluter Pfad sein (z. B. "d:\archives" oder "\\archives\public"). Wenn einer der nachfolgenden Pfade auch ein absoluter Pfad ist, verwirft der Kombinationsvorgang alle zuvor kombinierten Pfade und setzt auf diesen absoluten Pfad zurück.
Zeichenfolgen der Länge null werden aus dem kombinierten Pfad weggelassen.
Wenn path1
, path2
oder path3
kein Laufwerksverweis (d.h. "C:" oder "D:") ist und nicht mit einem gültigen Trennzeichen endet, wie in DirectorySeparatorChar, VolumeSeparatorCharAltDirectorySeparatorCharoder definiert, DirectorySeparatorChar wird ihr vor der Verkettung angefügt. Beachten Sie, dass die Methode das ursprüngliche Pfadtrennzeichen behält, wenn path1
, path2
oder path3
in einem Pfadtrennzeichen endet, Combine
das für die Zielplattform nicht geeignet ist. Im folgenden Beispiel wird das Ergebnis auf Windows- und Unix-basierten Systemen verglichen, wenn der umgekehrte Schrägstrich als Pfadtrennzeichen verwendet wird.
var result = Path.Combine(@"C:\Pictures\", @"Saved Pictures\", @"2019\", @"Jan\");
Console.WriteLine(result);
// The example displays the following output if run on a Windows system:
// C:\Pictures\Saved Pictures\2019\Jan\
//
// The example displays the following output if run on a Unix-based system:
// C:\Pictures\Saved Pictures\2019\Jan\
Dim result = Path.Combine("C:\Pictures\", "Saved Pictures\", "2019\", "Jan\")
Console.WriteLine(result)
' The example displays the following output if run on a Windows system:
' C:\Pictures\Saved Pictures\2019\Jan\
'
' The example displays the following output if run on a Unix-based system:
' C:\Pictures\Saved Pictures\2019\Jan\
Wenn path2
kein Stamm vorhanden ist (z. B. wenn path2
nicht mit einem Trennzeichen oder einer Laufwerksspezifikation gestartet wird), ist das Ergebnis eine Verkettung der beiden Pfade mit einem dazwischen liegenden Trennzeichen. Wenn path2
einen Stamm enthält, path2
wird zurückgegeben.
Die Parameter werden nicht analysiert, wenn sie Leerraum haben. path2
Wenn daher Leerzeichen enthält (z. B. " \file.txt "), wird path2
die Combine -Methode an path1
angefügt.
.NET Framework- und .NET Core-Versionen älter als 2.1: Nicht alle ungültigen Zeichen für Verzeichnis- und Dateinamen werden von der Combine
Methode als inakzeptabel interpretiert, da Sie diese Zeichen für Suchplatzhalterzeichen verwenden können. Wenn Sie beispielsweise Path.Combine("c:\\", "*.txt")
eine Datei daraus erstellen, ist sie zwar ungültig, aber sie ist als Suchzeichenfolge gültig. Sie wird daher von der Combine
-Methode erfolgreich interpretiert.