IsolatedStorageFileStream.WriteAsync 方法

定義

命名空間:

System.IO.IsolatedStorage

組件:

System.IO.IsolatedStorage.dll

多載

WriteAsync(Byte[], Int32, Int32, CancellationToken)	使用讀取自緩衝區 (由位元組陣列組成) 的資料，以非同步方式將位元組區塊寫入至隔離儲存區 (Isolated Storage) 檔案資料流物件。
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)	使用讀取自緩衝區 (由唯讀位元組記憶體範圍組成) 的資料，以非同步方式將位元組區塊寫入至隔離儲存區 (Isolated Storage) 檔案資料流物件。

WriteAsync(Byte[], Int32, Int32, CancellationToken)

來源:

IsolatedStorageFileStream.cs

使用讀取自緩衝區 (由位元組陣列組成) 的資料，以非同步方式將位元組區塊寫入至隔離儲存區 (Isolated Storage) 檔案資料流物件。

public:
 override System::Threading::Tasks::Task ^ WriteAsync(cli::array <System::Byte> ^ buffer, int offset, int count, System::Threading::CancellationToken cancellationToken);

public override System.Threading.Tasks.Task WriteAsync (byte[] buffer, int offset, int count, System.Threading.CancellationToken cancellationToken);

override this.WriteAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overrides Function WriteAsync (buffer As Byte(), offset As Integer, count As Integer, cancellationToken As CancellationToken) As Task

參數

buffer

Byte[]

要從中將位元組複製到目前隔離儲存區 (Isolated Storage) 檔案資料流的位元組陣列。

offset

Int32

buffer 中的位元組位移，即開始的位置。

count

Int32

寫入的最大位元組數。

cancellationToken

CancellationToken

用來監視是否有取消要求的語彙基元。 預設值是 None。

傳回

Task

表示非同步寫入作業的工作。

例外狀況

OperationCanceledException

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

備註

如果寫入作業成功，則物件的目前位置 IsolatedStorageFileStream 會由寫入的位元元組數目進階。 如果發生例外狀況，則物件的目前位置 IsolatedStorageFileStream 不會變更。

這個方法會儲存在工作中，它會傳回方法同步對應專案可以擲回的所有非使用狀況例外狀況。 如果例外狀況儲存在傳回的工作中，則會在等候工作時擲回該例外狀況。 使用狀況例外狀況，例如 ArgumentException，仍會同步擲回。 如需預存的例外狀況，請參閱 所 Write(Byte[], Int32, Int32)擲回的例外狀況。

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

來源:

IsolatedStorageFileStream.cs

使用讀取自緩衝區 (由唯讀位元組記憶體範圍組成) 的資料，以非同步方式將位元組區塊寫入至隔離儲存區 (Isolated Storage) 檔案資料流物件。

public override System.Threading.Tasks.ValueTask WriteAsync (ReadOnlyMemory<byte> buffer, System.Threading.CancellationToken cancellationToken = default);

override this.WriteAsync : ReadOnlyMemory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Overrides Function WriteAsync (buffer As ReadOnlyMemory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask

參數

buffer

ReadOnlyMemory<Byte>

要從中將位元組複製到目前隔離儲存區 (Isolated Storage) 檔案資料流的唯讀位元組記憶體。

cancellationToken

CancellationToken

用來監視是否有取消要求的語彙基元。 預設值是 None。

傳回

ValueTask

表示非同步寫入作業的工作。

例外狀況

OperationCanceledException

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