Path.Combine Path.Combine Path.Combine Path.Combine Method

定義

複数の文字列を 1 つのパスに結合します。Combines strings into a path.

オーバーロード

Combine(String[]) Combine(String[]) Combine(String[]) Combine(String[])

文字列の配列を 1 つのパスに結合します。Combines an array of strings into a path.

Combine(String, String) Combine(String, String) Combine(String, String) Combine(String, String)

2 つの文字列を 1 つのパスに結合します。Combines two strings into a path.

Combine(String, String, String) Combine(String, String, String) Combine(String, String, String) Combine(String, String, String)

3 つの文字列を 1 つのパスに結合します。Combines three strings into a path.

Combine(String, String, String, String) Combine(String, String, String, String) Combine(String, String, String, String) Combine(String, String, String, String)

4 つの文字列を 1 つのパスに結合します。Combines four strings into a path.

Combine(String[]) Combine(String[]) Combine(String[]) Combine(String[])

文字列の配列を 1 つのパスに結合します。Combines an array of strings into a path.

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[]

パスの構成要素の配列。An array of parts of the path.

戻り値

結合されたパス。The combined paths.

例外

配列内の文字列の 1 つが、GetInvalidPathChars() で定義された無効な文字を 1 つ以上含んでいます。One of the strings in the array contains one or more of the invalid characters defined in GetInvalidPathChars().

配列内の文字列の 1 つが null です。One of the strings in the array is null.

次の例では、パスに文字列の配列を結合します。The following example combines an array of strings into a path.

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 should be an array of the parts of the path to combine. 後続のパスのいずれかが絶対パスである場合は、し、結合操作をリセット前のすべての結合パスを破棄すること、その絶対パスで始まます。If the one of the subsequent paths is an absolute path, then the combine operation resets starting with that absolute path, discarding all previous combined paths.

長さ 0 の文字列は、結合されたパスから除外されます。Zero-length strings are omitted from the combined path.

パラメーターは、ホワイト スペースがある場合は解析されません。The parameters are not parsed if they have white space.

ディレクトリとファイル名のすべての無効な文字はによって許容として解釈されます、Combineメソッドでは、これらの文字を使用するにはワイルドカード文字の検索のためです。Not all invalid characters for directory and file names are interpreted as unacceptable by the Combine method, because you can use these characters for search wildcard characters. たとえば、Path.Combine("c:\\", "*.txt")有効でない可能性がありますからファイルを作成する場合は、検索文字列として有効です。For example, while Path.Combine("c:\\", "*.txt") might be invalid if you were to create a file from it, it is valid as a search string. 正常に解釈されますので、Combineメソッド。It is therefore successfully interpreted by the Combine method.

Combine(String, String) Combine(String, String) Combine(String, String) Combine(String, String)

2 つの文字列を 1 つのパスに結合します。Combines two strings into a path.

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 String String String

結合する 1 番目のパス。The first path to combine.

path2
String String String String

結合する 2 番目のパス。The second path to combine.

戻り値

結合されたパス。The combined paths. 指定したパスの 1 つが長さ 0 の文字列の場合、このメソッドは別のパスを返します。If one of the specified paths is a zero-length string, this method returns the other path. path2 に絶対パスが含まれる場合、このメソッドは path2 を返します。If path2 contains an absolute path, this method returns path2.

例外

path1 または path2 が、GetInvalidPathChars() で定義されている無効な文字を 1 つ以上含んでいます。path1 or path2 contains one or more of the invalid characters defined in GetInvalidPathChars().

path1 または path2null です。path1 or path2 is null.

次のコード例に示しますを使用して、 Combine Windows ベースのデスクトップ プラットフォーム上のメソッド。The following code example demonstrates using the Combine method on a Windows-based desktop platform.

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 = "";
        string path6 = null;

        CombinePaths(path1, path2);
        CombinePaths(path1, path3);
        CombinePaths(path3, path2);
        CombinePaths(path4, path2);
        CombinePaths(path5, path2);
        CombinePaths(path6, path2);
    }

    private static 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 == null)
                p1 = "null";
            if (p2 == null)
                p2 = "null";
            Console.WriteLine("You cannot combine '{0}' and '{1}' because: {2}{3}",
                        p1, p2, Environment.NewLine, e.Message);
        }

        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'
// 
// You cannot combine '' and 'subdir\file.txt' because: 
// Value cannot be null.
// Parameter name: path1
Imports System
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 'Main

    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 'CombinePaths
End Class 'ChangeExtensionTest
' 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

注釈

場合path1ドライブの参照 (つまり、「c:」または「d:」) ではないで定義されている有効な区切り記号で終わっていないDirectorySeparatorCharAltDirectorySeparatorChar、またはVolumeSeparatorCharDirectorySeparatorCharに追加されるpath1連結する前にします。If path1 is not a drive reference (that is, "C:" or "D:") and does not end with a valid separator character as defined in DirectorySeparatorChar, AltDirectorySeparatorChar, or VolumeSeparatorChar, DirectorySeparatorChar is appended to path1 before concatenation.

場合path2ルートは含まれません (場合など、path2区切り記号の文字またはドライブの仕様で始まらない)、介在する区切り記号文字で、2 つのパスを連結したものになります。If path2 does not include a root (for example, if path2 does not start with a separator character or a drive specification), the result is a concatenation of the two paths, with an intervening separator character. 場合path2、ルートが含まれていますpath2が返されます。If path2 includes a root, path2 is returned.

パラメーターは、ホワイト スペースがある場合は解析されません。The parameters are not parsed if they have white space. そのため場合、path2が空白文字 (たとえば、"\file.txt")、含まれています、Combineメソッドは、追加path2path1のみを返す代わりにpath2します。Therefore, if path2 includes white space (for example, " \file.txt "), the Combine method appends path2 to path1 instead of returning only path2.

ディレクトリとファイル名のすべての無効な文字はによって許容として解釈されます、Combineメソッドでは、これらの文字を使用するにはワイルドカード文字の検索のためです。Not all invalid characters for directory and file names are interpreted as unacceptable by the Combine method, because you can use these characters for search wildcard characters. たとえば、Path.Combine("c:\\", "*.txt")有効でない可能性がありますからファイルを作成する場合は、検索文字列として有効です。For example, while Path.Combine("c:\\", "*.txt") might be invalid if you were to create a file from it, it is valid as a search string. 正常に解釈されますので、Combineメソッド。It is therefore successfully interpreted by the Combine method.

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。For a list of common I/O tasks, see Common I/O Tasks.

こちらもご覧ください

Combine(String, String, String) Combine(String, String, String) Combine(String, String, String) Combine(String, String, String)

3 つの文字列を 1 つのパスに結合します。Combines three strings into a path.

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 String String String

結合する 1 番目のパス。The first path to combine.

path2
String String String String

結合する 2 番目のパス。The second path to combine.

path3
String String String String

結合する 3 番目のパス。The third path to combine.

戻り値

結合されたパス。The combined paths.

例外

path1path2、または path3 が、GetInvalidPathChars() で定義されている無効な文字を 1 つ以上含んでいます。path1, path2, or path3 contains one or more of the invalid characters defined in GetInvalidPathChars().

path1path2、または path3null です。path1, path2, or path3 is null.

次の例では、次の 3 つのパスを結合します。The following example combines three paths.

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")。path1 should be an absolute path (for example, "d:\archives" or "\\archives\public"). 場合path2またはpath3も絶対パス、結合操作の破棄を組み合わせて使用したすべてのパスと絶対パスにリセットします。If path2 or path3 is also an absolute path, the combine operation discards all previously combined paths and resets to that absolute path.

長さ 0 の文字列は、結合されたパスから除外されます。Zero-length strings are omitted from the combined path.

場合path1ドライブの参照 (つまり、「c:」または「d:」) ではないで定義されている有効な区切り記号で終わっていないDirectorySeparatorCharAltDirectorySeparatorChar、またはVolumeSeparatorCharDirectorySeparatorCharに追加されるpath1連結する前にします。If path1 is not a drive reference (that is, "C:" or "D:") and does not end with a valid separator character as defined in DirectorySeparatorChar, AltDirectorySeparatorChar, or VolumeSeparatorChar, DirectorySeparatorChar is appended to path1 before concatenation.

場合path2ルートは含まれません (場合など、path2区切り記号の文字またはドライブの仕様で始まらない)、介在する区切り記号文字で、2 つのパスを連結したものになります。If path2 does not include a root (for example, if path2 does not start with a separator character or a drive specification), the result is a concatenation of the two paths, with an intervening separator character. 場合path2、ルートが含まれていますpath2が返されます。If path2 includes a root, path2 is returned.

パラメーターは、ホワイト スペースがある場合は解析されません。The parameters are not parsed if they have white space. そのため場合、path2が空白文字 (たとえば、"\file.txt")、含まれています、Combineメソッドは、追加path2path1します。Therefore, if path2 includes white space (for example, " \file.txt "), the Combine method appends path2 to path1.

ディレクトリとファイル名のすべての無効な文字はによって許容として解釈されます、Combineメソッドでは、これらの文字を使用するにはワイルドカード文字の検索のためです。Not all invalid characters for directory and file names are interpreted as unacceptable by the Combine method, because you can use these characters for search wildcard characters. たとえば、Path.Combine("c:\\", "*.txt")有効でない可能性がありますからファイルを作成する場合は、検索文字列として有効です。For example, while Path.Combine("c:\\", "*.txt") might be invalid if you were to create a file from it, it is valid as a search string. 正常に解釈されますので、Combineメソッド。It is therefore successfully interpreted by the Combine method.

Combine(String, String, String, String) Combine(String, String, String, String) Combine(String, String, String, String) Combine(String, String, String, String)

4 つの文字列を 1 つのパスに結合します。Combines four strings into a path.

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 String String String

結合する 1 番目のパス。The first path to combine.

path2
String String String String

結合する 2 番目のパス。The second path to combine.

path3
String String String String

結合する 3 番目のパス。The third path to combine.

path4
String String String String

結合する 4 番目のパス。The fourth path to combine.

戻り値

結合されたパス。The combined paths.

例外

path1path2path3、または path4 が、GetInvalidPathChars() で定義されている無効な文字を 1 つ以上含んでいます。path1, path2, path3, or path4 contains one or more of the invalid characters defined in GetInvalidPathChars().

path1path2path3、または path4null です。path1, path2, path3, or path4 is null.

次の例では、次の 4 つのパスを結合します。The following example combines four paths.

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")。後続のパスのいずれかが絶対パスでも場合、結合操作はすべて以前に結合されたパスを破棄し、その絶対パスにリセットします。path1 should be an absolute path (for example, "d:\archives" or "\\archives\public").If one of the subsequent paths is also an absolute path, the combine operation discards all previously combined paths and resets to that absolute path.

長さ 0 の文字列は、結合されたパスから除外されます。Zero-length strings are omitted from the combined path.

場合path1ドライブの参照 (つまり、「c:」または「d:」) ではないで定義されている有効な区切り記号で終わっていないDirectorySeparatorCharAltDirectorySeparatorChar、またはVolumeSeparatorCharDirectorySeparatorCharに追加されるpath1連結する前にします。If path1 is not a drive reference (that is, "C:" or "D:") and does not end with a valid separator character as defined in DirectorySeparatorChar, AltDirectorySeparatorChar, or VolumeSeparatorChar, DirectorySeparatorChar is appended to path1 before concatenation.

場合path2ルートは含まれません (場合など、path2区切り記号の文字またはドライブの仕様で始まらない)、介在する区切り記号文字で、2 つのパスを連結したものになります。If path2 does not include a root (for example, if path2 does not start with a separator character or a drive specification), the result is a concatenation of the two paths, with an intervening separator character. 場合path2、ルートが含まれていますpath2が返されます。If path2 includes a root, path2 is returned.

パラメーターは、ホワイト スペースがある場合は解析されません。The parameters are not parsed if they have white space. そのため場合、path2が空白文字 (たとえば、"\file.txt")、含まれています、Combineメソッドは、追加path2path1します。Therefore, if path2 includes white space (for example, " \file.txt "), the Combine method appends path2 to path1.

ディレクトリとファイル名のすべての無効な文字はによって許容として解釈されます、Combineメソッドでは、これらの文字を使用するにはワイルドカード文字の検索のためです。Not all invalid characters for directory and file names are interpreted as unacceptable by the Combine method, because you can use these characters for search wildcard characters. たとえば、Path.Combine("c:\\", "*.txt")有効でない可能性がありますからファイルを作成する場合は、検索文字列として有効です。For example, while Path.Combine("c:\\", "*.txt") might be invalid if you were to create a file from it, it is valid as a search string. 正常に解釈されますので、Combineメソッド。It is therefore successfully interpreted by the Combine method.

適用対象