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)

Source:

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)

Source:

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 系统中的文件路径格式