Path.TryJoin メソッド

定義

個々のパス コンポーネントを事前に割り当てられた文字範囲に連結することを試み、この操作が成功したかどうかを示す値を返します。Attempts to concatenate individual path components to a preallocated character span, and returns a value that indicates whether the operation succeeded.

オーバーロード

TryJoin(ReadOnlySpan<Char>, ReadOnlySpan<Char>, ReadOnlySpan<Char>, Span<Char>, Int32)

2 つのパス コンポーネントを事前に割り当てられた単一の文字範囲に連結することを試み、この操作が成功したかどうかを示す値を返します。Attempts to concatenate two path components to a single preallocated character span, and returns a value that indicates whether the operation succeeded.

TryJoin(ReadOnlySpan<Char>, ReadOnlySpan<Char>, Span<Char>, Int32)

2 つのパス コンポーネントを事前に割り当てられた単一の文字範囲に連結することを試み、この操作が成功したかどうかを示す値を返します。Attempts to concatenate two path components to a single preallocated character span, and returns a value that indicates whether the operation succeeded.

注釈

コピー先の文字範囲は、連結されたパスを保持するのに十分な大きさである必要があります。The destination character span must be large enough to hold the concatenated path. 次の例に示すように、Span<T>.Slice メソッドを呼び出すことによって、連結されたパスを取得できます。You can then retrieve the concatenated path by calling the Span<T>.Slice method, as the following example illustrates.

using System;
using System.IO;

class Program
{
    static void Main()
    {
        int nChars = 0;
        var buffer = new Span<Char>(new String(' ', 100).ToCharArray());
        var flag = Path.TryJoin("C:/".AsSpan(), "Users/user1".AsSpan(), buffer, out nChars);
        if (flag) 
            Console.WriteLine($"Wrote {nChars} characters: '{buffer.Slice(0, nChars).ToString()}'");
        else
            Console.WriteLine("Concatenation operation failed.");
    }
}

TryJoin(ReadOnlySpan<Char>, ReadOnlySpan<Char>, ReadOnlySpan<Char>, Span<Char>, Int32)

2 つのパス コンポーネントを事前に割り当てられた単一の文字範囲に連結することを試み、この操作が成功したかどうかを示す値を返します。Attempts to concatenate two path components to a single preallocated character span, and returns a value that indicates whether the operation succeeded.

public:
 static bool TryJoin(ReadOnlySpan<char> path1, ReadOnlySpan<char> path2, ReadOnlySpan<char> path3, Span<char> destination, [Runtime::InteropServices::Out] int % charsWritten);
public static bool TryJoin (ReadOnlySpan<char> path1, ReadOnlySpan<char> path2, ReadOnlySpan<char> path3, Span<char> destination, out int charsWritten);
static member TryJoin : ReadOnlySpan<char> * ReadOnlySpan<char> * ReadOnlySpan<char> * Span<char> * int -> bool
Public Shared Function TryJoin (path1 As ReadOnlySpan(Of Char), path2 As ReadOnlySpan(Of Char), path3 As ReadOnlySpan(Of Char), destination As Span(Of Char), ByRef charsWritten As Integer) As Boolean

パラメーター

path1
ReadOnlySpan<Char>

結合する最初のパスを含む文字範囲。A character span that contains the first path to join.

path2
ReadOnlySpan<Char>

結合する 2 番目のパスを含む文字範囲。A character span that contains the second path to join.

path3
ReadOnlySpan<Char>

結合する 3 番目のパスを含む文字範囲。A character span that contains the third path to join.

destination
Span<Char>

連結されたパスを保持する文字範囲。A character span to hold the concatenated path.

charsWritten
Int32

メソッドから制御が戻ったときに、destination に書き込まれた文字数を示す値。When the method returns, a value that indicates the number of characters written to the destination.

戻り値

連結操作が正常に終了した場合は true。それ以外の場合は falsetrue if the concatenation operation is successful; otherwise, false.

注釈

destination は、連結されたパスを保持するのに十分な大きさである必要があります。destination must be large enough to hold the concatenated path. この例に示すように、Span<T>.Slice メソッドを呼び出すことによって、連結されたパスを取得できます。You can then retrieve the concatenated path by calling the Span<T>.Slice method, as the example illustrates.

こちらもご覧ください

TryJoin(ReadOnlySpan<Char>, ReadOnlySpan<Char>, Span<Char>, Int32)

2 つのパス コンポーネントを事前に割り当てられた単一の文字範囲に連結することを試み、この操作が成功したかどうかを示す値を返します。Attempts to concatenate two path components to a single preallocated character span, and returns a value that indicates whether the operation succeeded.

public:
 static bool TryJoin(ReadOnlySpan<char> path1, ReadOnlySpan<char> path2, Span<char> destination, [Runtime::InteropServices::Out] int % charsWritten);
public static bool TryJoin (ReadOnlySpan<char> path1, ReadOnlySpan<char> path2, Span<char> destination, out int charsWritten);
static member TryJoin : ReadOnlySpan<char> * ReadOnlySpan<char> * Span<char> * int -> bool
Public Shared Function TryJoin (path1 As ReadOnlySpan(Of Char), path2 As ReadOnlySpan(Of Char), destination As Span(Of Char), ByRef charsWritten As Integer) As Boolean

パラメーター

path1
ReadOnlySpan<Char>

結合する最初のパスを含む文字範囲。A character span that contains the first path to join.

path2
ReadOnlySpan<Char>

結合する 2 番目のパスを含む文字範囲。A character span that contains the second path to join.

destination
Span<Char>

連結されたパスを保持する文字範囲。A character span to hold the concatenated path.

charsWritten
Int32

メソッドから制御が戻ったときに、destination に書き込まれた文字数を示す値。When the method returns, a value that indicates the number of characters written to the destination.

戻り値

連結操作が正常に終了した場合は true。それ以外の場合は falsetrue if the concatenation operation is successful; otherwise, false.

注釈

destination は、連結されたパスを保持するのに十分な大きさである必要があります。destination must be large enough to hold the concatenated path. この例に示すように、Span<T>.Slice メソッドを呼び出すことによって、連結されたパスを取得できます。You can then retrieve the concatenated path by calling the Span<T>.Slice method, as the example illustrates.

こちらもご覧ください

適用対象