File.WriteAllBytesAsync メソッド

定義

名前空間:

System.IO

アセンブリ:

netstandard.dll, System.Runtime.dll

オーバーロード

WriteAllBytesAsync(String, Byte[], CancellationToken)	新しいファイルを非同期に作成し、指定したバイト配列をファイルに書き込んでから、ファイルを閉じます。 ターゲット ファイルが既に存在する場合は、切り捨てられ、上書きされます。
WriteAllBytesAsync(String, ReadOnlyMemory<Byte>, CancellationToken)	新しいファイルを非同期に作成し、指定したバイト配列をファイルに書き込んでから、ファイルを閉じます。 ターゲット ファイルが既に存在する場合は、切り捨てられ、上書きされます。

WriteAllBytesAsync(String, Byte[], CancellationToken)

ソース:

File.cs

新しいファイルを非同期に作成し、指定したバイト配列をファイルに書き込んでから、ファイルを閉じます。 ターゲット ファイルが既に存在する場合は、切り捨てられ、上書きされます。

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

パラメーター

path

String

書き込むファイル。

bytes

Byte[]

ファイルに書き込むバイト数。

cancellationToken

CancellationToken

キャンセル要求を監視するトークン。 既定値は Noneです。

戻り値

Task

非同期書き込み操作を表すタスク。

例外

OperationCanceledException

キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。

注釈

このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentExceptionなどの使用例外は、引き続き同期的にスローされます。 格納されている例外については、WriteAllBytes(String, Byte[])によってスローされる例外を参照してください。

WriteAllBytesAsync(String, ReadOnlyMemory<Byte>, CancellationToken)

新しいファイルを非同期に作成し、指定したバイト配列をファイルに書き込んでから、ファイルを閉じます。 ターゲット ファイルが既に存在する場合は、切り捨てられ、上書きされます。

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

パラメーター

path

String

書き込むファイル。

bytes

ReadOnlyMemory<Byte>

ファイルに書き込むバイト数。

cancellationToken

CancellationToken

キャンセル要求を監視するトークン。 既定値は Noneです。

戻り値

Task

非同期書き込み操作を表すタスク。

例外

ArgumentNullException

path は nullです。

ArgumentException

path が空です。

OperationCanceledException

キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。