Path.Combine メソッド

定義

名前空間:

System.IO

アセンブリ:

System.Runtime.dll

複数の文字列を 1 つのパスに結合します。

オーバーロード

Combine(String[])	文字列の配列を 1 つのパスに結合します。
Combine(String, String)	2 つの文字列を 1 つのパスに結合します。
Combine(String, String, String)	3 つの文字列を 1 つのパスに結合します。
Combine(String, String, String, String)	4 つの文字列を 1 つのパスに結合します。

注釈

このメソッドは、個々の文字列をファイル パスを表す 1 つの文字列に連結することを目的としています。 ただし、最初の以外の引数にルートパスが含まれている場合、以前のパスコンポーネントはすべて無視され、返される文字列はそのルートパスコンポーネントで始まります。 メソッドの代わりにCombine、 メソッドまたは TryJoin メソッドの使用をJoin検討してください。

重要

このメソッドは、最初の引数が絶対パスであり、次の引数が相対パスであることを前提としています。 そうでない場合、特に後続の引数がユーザーによって入力された文字列である場合は、代わりに または TryJoin メソッドをJoin呼び出します。

Combine(String[])

ソース:

Path.cs

文字列の配列を 1 つのパスに結合します。

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

パラメーター

paths

String[]

パスの構成要素の配列。

戻り値

String

結合されたパス。

例外

ArgumentException

.NET Framework バージョンと .NET Core バージョンが 2.1 より前の場合: 配列内の文字列の 1 つに、 でGetInvalidPathChars()定義されている無効な文字が 1 つ以上含まれています。

ArgumentNullException

配列内の文字列の 1 つが null です。

例

次の例では、文字列の配列をパスに結合します。

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)

注釈

paths は、結合するパスの部分の配列である必要があります。 後続のパスのいずれかが絶対パスの場合、結合操作は、その絶対パスからリセットされ、以前の結合パスがすべて破棄されます。

内のpaths要素が最後の要素ではなく、 または AltDirectorySeparatorChar 文字でDirectorySeparatorChar終わらない場合、Combineメソッドはその要素と次の要素の間に文字を追加DirectorySeparatorCharします。 要素がターゲット プラットフォームに適さないパス区切り文字で終わる場合、メソッドは元のパス区切り文字を保持し、 Combine サポートされている文字を追加します。 次の例では、円記号をパス区切り文字として使用する場合の Windows および Unix ベースのシステムの結果を比較します。

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

長さ 0 の文字列は、結合パスから省略されます。

空白がある場合、パラメーターは解析されません。

2.1 より前のバージョンの.NET Frameworkと .NET Core: 検索ワイルドカード文字にこれらの文字を使用できるため、ディレクトリ名とファイル名に対するすべての無効な文字がメソッドによってCombine受け入れられないと解釈されるわけではありません。 たとえば、 Path.Combine("c:\\", "*.txt") ファイルを作成する場合は無効である可能性があります。一方、検索文字列として有効です。 したがって、 メソッドによって Combine 正常に解釈されます。

こちらもご覧ください

• Windows システムのファイル パス形式

Combine(String, String)

ソース:

Path.cs

2 つの文字列を 1 つのパスに結合します。

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

パラメーター

path1

String

結合する 1 番目のパス。

path2

String

結合する 2 番目のパス。

戻り値

String

結合されたパス。 指定したパスの 1 つが長さ 0 の文字列の場合、このメソッドは別のパスを返します。 path2 に絶対パスが含まれる場合、このメソッドは path2 を返します。

例外

ArgumentException

.NET Framework および .NET Core バージョンが 2.1 より前の場合: path1 または path2 にGetInvalidPathChars()定義されている無効な文字が 1 つ以上含まれています。

ArgumentNullException

path1 または path2 が null です。

例

次の例では、Windows での メソッドの Combine 使用を示します。

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:^*&)(_=@#'\\^&#2.*(.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:^*&)(_=@#'\\^&#2.*(.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:^*&)(_=@#'\^&#2.*(.txt' and 'subdir\file.txt', the result is:
// 'c:^*&)(_=@#'\^&#2.*(.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:^*&)(_=@#'\\^&#2.*(.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:^*&)(_=@#'\^&#2.*(.txt' and 'subdir\file.txt', the result is: 
' 'c:^*&)(_=@#'\^&#2.*(.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

注釈

がドライブ参照 (つまり、"C:" または "D:") ではなく、連結の前に に AltDirectorySeparatorChar、、または DirectorySeparatorCharVolumeSeparatorCharでDirectorySeparatorChar定義されているpath1有効な区切り文字で終わらない場合path1。 ターゲット プラットフォームに適さないパス区切り文字で終わる場合 path1 、 Combine メソッドは元のパス区切り文字を保持し、サポートされている文字を追加します。 次の例では、円記号をパス区切り文字として使用する場合の Windows および Unix ベースのシステムの結果を比較します。

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

がルートを含まない場合 path2 (たとえば、 が区切り文字またはドライブ指定で始まらない場合 path2 )、結果は 2 つのパスの連結であり、間に区切り文字が含まれます。 ルートが含まれている場合 path2 は、 path2 が返されます。

空白がある場合、パラメーターは解析されません。 したがって、 に空白 (例: " \file.txt ") Combine が含まれている場合path2、メソッドは のみをpath2返すのではなく にpath1を追加path2します。

2.1 より前のバージョンの.NET Frameworkと .NET Core: 検索ワイルドカード文字にこれらの文字を使用できるため、ディレクトリ名とファイル名に対するすべての無効な文字がメソッドによってCombine受け入れられないと解釈されるわけではありません。 たとえば、 Path.Combine("c:\\", "*.txt") ファイルを作成する場合は無効である可能性があります。一方、検索文字列として有効です。 したがって、 メソッドによって Combine 正常に解釈されます。

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。

こちらもご覧ください

• Windows システムのファイル パス形式
• ファイルおよびストリーム入出力
• 方法: ファイルからのテキストの読み取り
• 方法: テキストのファイルへの書き込み

Combine(String, String, String)

ソース:

Path.cs

3 つの文字列を 1 つのパスに結合します。

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

パラメーター

path1

String

結合する 1 番目のパス。

path2

String

結合する 2 番目のパス。

path3

String

結合する 3 番目のパス。

戻り値

String

結合されたパス。

例外

ArgumentException

.NET Framework バージョンと .NET Core バージョンが 2.1 より前の場合: path1、path2、または path3 にGetInvalidPathChars()定義されている無効な文字が 1 つ以上含まれています。

ArgumentNullException

path1、path2、または path3 が null です。

例

次の例では、3 つのパスを結合します。

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)

注釈

path1 は絶対パスである必要があります (たとえば、"d:\archives" や "\\archives\public")。 または path3 が絶対パスでもある場合path2、結合操作は以前に結合されたすべてのパスを破棄し、その絶対パスにリセットします。

長さ 0 の文字列は、結合パスから省略されます。

または path2 がドライブ参照 (つまり、"C:" または "D:") であり、連結の前に 、AltDirectorySeparatorChar、または path2VolumeSeparatorCharpath1DirectorySeparatorChar で定義されている有効な区切り文字でDirectorySeparatorChar終わらない場合path1。 ターゲット プラットフォームに適さないパス区切り文字で終わる場合path1path2、メソッドは元のパス区切り文字を保持し、Combineサポートされている区切り文字を追加します。 次の例では、円記号をパス区切り文字として使用する場合の Windows および Unix ベースのシステムの結果を比較します。

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

がルートを含まない場合 path2 (たとえば、 が区切り文字またはドライブ指定で始まらない場合 path2 )、結果は 2 つのパスの連結であり、間に区切り文字が含まれます。 ルートが含まれている場合 path2 は、 path2 が返されます。

空白がある場合、パラメーターは解析されません。 したがって、 に空白 (例: " \file.txt ") が含まれている場合path2、 メソッドは Combine にpath1を追加しますpath2。

2.1 より前のバージョンの.NET Frameworkと .NET Core: 検索ワイルドカード文字にこれらの文字を使用できるため、ディレクトリ名とファイル名に対するすべての無効な文字がメソッドによってCombine受け入れられないと解釈されるわけではありません。 たとえば、 Path.Combine("c:\\", "*.txt") ファイルを作成する場合は無効である可能性があります。一方、検索文字列として有効です。 したがって、 メソッドによって Combine 正常に解釈されます。

こちらもご覧ください

• Windows システムのファイル パス形式

Combine(String, String, String, String)

ソース:

Path.cs

4 つの文字列を 1 つのパスに結合します。

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

パラメーター

path1

String

結合する 1 番目のパス。

path2

String

結合する 2 番目のパス。

path3

String

結合する 3 番目のパス。

path4

String

結合する 4 番目のパス。

戻り値

String

結合されたパス。

例外

ArgumentException

.NET Framework バージョンと .NET Core バージョンが 2.1 より前の場合: path1、path2、path3、または path4 にGetInvalidPathChars()定義されている無効な文字が 1 つ以上含まれています。

ArgumentNullException

path1、path2、path3、または path4 が null です。

例

次の例では、4 つのパスを結合します。

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)

注釈

path1 は絶対パスである必要があります (たとえば、"d:\archives" や "\\archives\public")。 後続のパスの 1 つが絶対パスでもある場合、結合操作では、以前に結合されたすべてのパスが破棄され、その絶対パスにリセットされます。

長さ 0 の文字列は、結合パスから省略されます。

、、または がドライブ参照 (つまり、"C:" または "D:") ではなく、連結の前に 、AltDirectorySeparatorChar、または VolumeSeparatorCharDirectorySeparatorChar で定義されている有効な区切り文字でDirectorySeparatorChar終わらない場合path1。path3path2 、path2、または path3 がターゲット プラットフォームに適さないパス区切り文字で終わる場合path1、メソッドは元のパス区切り文字を保持し、Combineサポートされている文字を追加します。 次の例では、円記号をパス区切り文字として使用する場合の Windows および Unix ベースのシステムの結果を比較します。

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\

がルートを含まない場合 path2 (たとえば、 が区切り文字またはドライブ指定で始まらない場合 path2 )、結果は 2 つのパスの連結であり、間に区切り文字が含まれます。 ルートが含まれている場合 path2 は、 path2 が返されます。

空白がある場合、パラメーターは解析されません。 したがって、 に空白 (例: " \file.txt ") が含まれている場合path2、 メソッドは Combine にpath1を追加しますpath2。

2.1 より前のバージョンの.NET Frameworkと .NET Core: 検索ワイルドカード文字にこれらの文字を使用できるため、ディレクトリ名とファイル名に対するすべての無効な文字がメソッドによってCombine受け入れられないと解釈されるわけではありません。 たとえば、 Path.Combine("c:\\", "*.txt") ファイルを作成する場合は無効である可能性があります。一方、検索文字列として有効です。 したがって、 メソッドによって Combine 正常に解釈されます。

こちらもご覧ください

• Windows システムのファイル パス形式