File.AppendAllBytesAsync 方法

定義

命名空間:

System.IO

組件:

System.Runtime.dll

多載

AppendAllBytesAsync(String, Byte[], CancellationToken)	以異步方式將指定的位元組數位附加至指定路徑的檔案結尾。 如果檔案不存在，這個方法會建立新的檔案。 如果作業已取消，工作會以已取消的狀態傳回。
AppendAllBytesAsync(String, ReadOnlyMemory<Byte>, CancellationToken)	以異步方式將指定的位元組數位附加至指定路徑的檔案結尾。 如果檔案不存在，這個方法會建立新的檔案。 如果作業已取消，工作會以已取消的狀態傳回。

AppendAllBytesAsync(String, Byte[], CancellationToken)

來源:

File.cs

以異步方式將指定的位元組數位附加至指定路徑的檔案結尾。

如果檔案不存在，這個方法會建立新的檔案。 如果作業已取消，工作會以已取消的狀態傳回。

public static System.Threading.Tasks.Task AppendAllBytesAsync (string path, byte[] bytes, System.Threading.CancellationToken cancellationToken = default);

static member AppendAllBytesAsync : string * byte[] * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Shared Function AppendAllBytesAsync (path As String, bytes As Byte(), Optional cancellationToken As CancellationToken = Nothing) As Task

參數

path

String

要附加的檔案。

bytes

Byte[]

要附加至檔案的位元組。

cancellationToken

CancellationToken

要監視取消要求的令牌。 預設值為 None。

傳回

Task

例外狀況

ArgumentNullException

path 或 bytesnull。

ArgumentException

path 是空的。

OperationCanceledException

取消令牌已取消。 此例外狀況會儲存在傳回的工作中。

AppendAllBytesAsync(String, ReadOnlyMemory<Byte>, CancellationToken)

以異步方式將指定的位元組數位附加至指定路徑的檔案結尾。

如果檔案不存在，這個方法會建立新的檔案。 如果作業已取消，工作會以已取消的狀態傳回。

public static System.Threading.Tasks.Task AppendAllBytesAsync (string path, ReadOnlyMemory<byte> bytes, System.Threading.CancellationToken cancellationToken = default);

static member AppendAllBytesAsync : string * ReadOnlyMemory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Shared Function AppendAllBytesAsync (path As String, bytes As ReadOnlyMemory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As Task

參數

path

String

要附加的檔案。

bytes

ReadOnlyMemory<Byte>

要附加至檔案的位元組。

cancellationToken

CancellationToken

要監視取消要求的令牌。 預設值為 None。

傳回

Task

例外狀況

ArgumentNullException

path null。

ArgumentException

path 是空的。

OperationCanceledException

取消令牌已取消。 此例外狀況會儲存在傳回的工作中。