Path.TryJoin 方法

定義

命名空間:

System.IO

組件:

System.Runtime.dll

嘗試將個別路徑元件串連成預先配置的字元範圍，然後傳回值，指出作業是否成功。

多載

TryJoin(ReadOnlySpan<Char>, ReadOnlySpan<Char>, ReadOnlySpan<Char>, Span<Char>, Int32)	嘗試將三個路徑元件串連至單一預先配置字元範圍，並傳回值，指出作業是否成功。
TryJoin(ReadOnlySpan<Char>, ReadOnlySpan<Char>, Span<Char>, Int32)	嘗試將兩個路徑元件串連成單一預先配置的字元範圍，然後傳回值，指出作業是否成功。

備註

目的地字元範圍必須夠大，才能保存串連路徑。 接著，您可以藉由呼叫 Span<T>.Slice 方法來擷取串連路徑，如下列範例所示。

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)

來源:

Path.cs

嘗試將三個路徑元件串連至單一預先配置字元範圍，並傳回值，指出作業是否成功。

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>

包含第一個聯結路徑的字元範圍。

path2

ReadOnlySpan<Char>

包含第二個聯結路徑的字元範圍。

path3

ReadOnlySpan<Char>

包含第三個聯結路徑的字元範圍。

destination

Span<Char>

保留串連路徑的字元範圍。

charsWritten

Int32

當方法傳回值時，該值會指出寫入 destination 的字元數目。

傳回

Boolean

如果串連作業成功，則為 true；否則為 false。

備註

destination 必須夠大，才能保存串連路徑。 接著，您可以藉由呼叫 Span<T>.Slice 方法來擷取串連路徑，如範例所示。

另請參閱

• Windows 系統上的檔案路徑格式

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

來源:

Path.cs

嘗試將兩個路徑元件串連成單一預先配置的字元範圍，然後傳回值，指出作業是否成功。

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>

包含第一個聯結路徑的字元範圍。

path2

ReadOnlySpan<Char>

包含第二個聯結路徑的字元範圍。

destination

Span<Char>

保留串連路徑的字元範圍。

charsWritten

Int32

當方法傳回值時，該值會指出寫入 destination 的字元數目。

傳回

Boolean

如果串連作業成功，則為 true；否則為 false。

備註

destination 必須夠大，才能保存串連路徑。 接著，您可以藉由呼叫 Span<T>.Slice 方法來擷取串連路徑，如範例所示。

另請參閱

• Windows 系統上的檔案路徑格式