System.IOUtils.TPath.Combine

• Übergeordnet: TPath

Delphi

class function Combine(const Path1, Path2: string; const ValidateParams: Boolean = True): string; overload; inline; static;
class function Combine(const Path1, Path2, Path3: string; const ValidateParams: Boolean = True): string; overload; static;
class function Combine(const Path1, Path2, Path3, Path4: string; const ValidateParams: Boolean = True): string; overload; static;
class function Combine(const Paths: array of string; const ValidateParams: Boolean = True): string; overload; static;

C++

static System::UnicodeString __fastcall Combine(const System::UnicodeString Path1, const System::UnicodeString Path2, const bool ValidateParams = true)/* overload */;
static System::UnicodeString __fastcall Combine(const System::UnicodeString Path1, const System::UnicodeString Path2, const System::UnicodeString Path3, const bool ValidateParams = true)/* overload */;
static System::UnicodeString __fastcall Combine(const System::UnicodeString Path1, const System::UnicodeString Path2, const System::UnicodeString Path3, const System::UnicodeString Path4, const bool ValidateParams = true)/* overload */;
static System::UnicodeString __fastcall Combine(const System::UnicodeString *Paths, const System::NativeInt Paths_High, const bool ValidateParams = true)/* overload */;

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
function	public	System.IOUtils.pas System.IOUtils.hpp	System.IOUtils	TPath

Beschreibung

Kombiniert zwei Pfad-Strings.

Mit Combine erhalten Sie einen neuen kombinierten Pfad aus zwei verschiedenen Pfaden. Wenn es sich bei dem zweiten Pfad um einen absoluten Pfad handelt, gibt Combine ihn direkt zurück. Andernfalls gibt Combine den ersten mit dem zweiten Pfad verkettet zurück.

In der folgenden Tabelle sind die von dieser Methode erwarteten Parameter aufgeführt:

Name	Bedeutung
Path1	Der erste Pfad. Path1 wird als Ausgangspunkt für Path2 verwendet.
Path2	Der Pfad wird mit Path1 verkettet.

Hinweis: Combine löst eine Exception aus, wenn die gegebenen Pfade ungültige Zeichen enthalten.

Beispiele

In den folgenden Beispielen wird die Funktion TPath.Combine zum Kombinieren zweier Dateipfade verwendet. In der Tabelle werden das erwartete Ergebnis gezeigt und jedes Beispiel kurz erklärt.

Eingabe	Ausgabe	Beschreibung
TPath.combine('E:\somewhere\', 'there\file.txt')	'E:\somewhere\there\file.txt'	Dies ist die empfohlene Art für die Verwendung dieser API. In diesem Fall ist das Ergebnis der vollständige Pfad zu der .txt-Datei.
TPath.combine('E:\somewhere', 'there\file.txt')	'E:\somewhere\there\file.txt'	TPath.Combine kombiniert zwei Pfade, auch wenn der erste Pfad nicht mit einem Backslash endet und gibt den korrekten vollständigen Pfad zu der .txt-Datei zurück.
TPath.combine('E:\somewhere', '\there\file.txt')	'\there\file.txt'	In diesem Beispiel kombiniert TPath.Combine die Pfade nicht, weil der zweite Pfad mit einem Backslash beginnt. Die Funktion gibt nur den zweiten Pfad zurück.
TPath.combine('E:\somewhere', 'C:\there\file.txt')	'C:\there\file.txt'	TPath.Combine kann zwei unterschiedliche Pfade nicht kombinieren. In diesem Fall gibt die Funktion nur den zweiten Pfad zurück.

Hinweis: Bitte denken Sie daran, dass .\ und ..\ noch nicht gelöst sind.

Siehe auch

• GetFullPath

• GetFileName