File.WriteAllBytesAsync 方法

定義

命名空間:: System.IO

組件:: netstandard.dll, System.Runtime.dll

組件:: netstandard.dll, System.IO.FileSystem.dll

組件:: netstandard.dll, System.IO.FileSystem.dll, System.Runtime.dll

組件:: System.IO.FileSystem.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

名稱	Description
WriteAllBytesAsync(String, Byte[], CancellationToken)	非同步建立新檔案，將指定的位元組陣列寫入檔案，然後關閉該檔案。如果目標檔案已經存在，則會遭到截斷並覆寫。
WriteAllBytesAsync(String, ReadOnlyMemory<Byte>, CancellationToken)	非同步建立新檔案，將指定的位元組陣列寫入檔案，然後關閉該檔案。如果目標檔案已經存在，則會遭到截斷並覆寫。

WriteAllBytesAsync(String, Byte[], CancellationToken)

來源:: File.cs

來源:: File.cs

來源:: File.cs

來源:: File.cs

來源:: File.cs

非同步建立新檔案，將指定的位元組陣列寫入檔案，然後關閉該檔案。如果目標檔案已經存在，則會遭到截斷並覆寫。

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

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

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

參數

path: String

要寫入的檔案。

bytes: Byte[]

寫入檔案的位元組。

cancellationToken: CancellationToken

用來監控取消申請的代幣。預設值為 None。

傳回

Task

一個代表非同步寫入操作的任務。

例外狀況

OperationCanceledException

取消令牌也被取消了。此例外會儲存在回傳的任務中。

備註

此方法在任務中儲存所有非使用例外，該方法的同步對應程式可拋出這些例外。如果回傳的任務中儲存了例外，該例外會在等待任務時拋出。使用例外錯誤，例如 ArgumentException，仍會同步拋出。關於儲存的例外，請參見由 WriteAllBytes(String, Byte[])拋出的例外。

適用於

WriteAllBytesAsync(String, ReadOnlyMemory<Byte>, CancellationToken)

來源:: File.cs

來源:: File.cs

來源:: File.cs

非同步建立新檔案，將指定的位元組陣列寫入檔案，然後關閉該檔案。如果目標檔案已經存在，則會遭到截斷並覆寫。

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

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

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