BrotliStream.WriteAsync 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| WriteAsync(ReadOnlyMemory<Byte>, CancellationToken) |
非同步地將壓縮的位元組寫入底層的 Brotli 串流，從指定的位元組記憶體範圍中。 |
| WriteAsync(Byte[], Int32, Int32, CancellationToken) |
非同步地從指定的位元組陣列寫入壓縮後的 Brotli 串流。 |
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)
非同步地將壓縮的位元組寫入底層的 Brotli 串流，從指定的位元組記憶體範圍中。
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.ValueTaskPublic Overrides Function WriteAsync (buffer As ReadOnlyMemory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask參數
- buffer
- ReadOnlyMemory<Byte>
用來寫入資料的記憶體區域。
- cancellationToken
- CancellationToken
用來監控取消申請的代幣。 預設值為 None。
傳回
一個代表非同步寫入操作的任務。
例外狀況
取消令牌也被取消了。 此例外會儲存在回傳的任務中。
備註
「WriteAsync」方法讓你能執行資源密集型的 I/O 操作，而不阻塞主執行緒。 在 Windows 8.x 市集應用程式或傳統型應用程式中，此效能考慮特別重要，其中耗時的串流作業可能會封鎖 UI 線程，並讓應用程式看起來好像無法運作。 非同步方法與 async 和 await 關鍵字搭配使用 Visual Basic 和 C# 中。
利用該 CanWrite 屬性判斷目前實例是否支援寫入。
若操作在完成前被取消，回傳的任務會包含 Canceled 該 Status 屬性的值。
適用於
WriteAsync(Byte[], Int32, Int32, CancellationToken)
非同步地從指定的位元組陣列寫入壓縮後的 Brotli 串流。
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.TaskPublic Overrides Function WriteAsync (buffer As Byte(), offset As Integer, count As Integer, cancellationToken As CancellationToken) As Task參數
- buffer
- Byte[]
就是包含要壓縮資料的緩衝區。
- offset
- Int32
以零為基礎的位元組偏移 buffer 量，從中開始將位元組複製到 Brotli 串流。
- count
- Int32
最大可寫入位元組數。
- cancellationToken
- CancellationToken
用來監控取消申請的代幣。 預設值為 None。
傳回
一個代表非同步寫入操作的任務。
例外狀況
取消令牌也被取消了。 此例外會儲存在回傳的任務中。
備註
「WriteAsync」方法讓你能執行資源密集型的 I/O 操作，而不阻塞主執行緒。 在 Windows 8.x 市集應用程式或傳統型應用程式中，此效能考慮特別重要，其中耗時的串流作業可能會封鎖 UI 線程，並讓應用程式看起來好像無法運作。 非同步方法與 async 和 await 關鍵字搭配使用 Visual Basic 和 C# 中。
利用該 CanWrite 屬性判斷目前實例是否支援寫入。
若操作在完成前被取消，回傳的任務會包含 Canceled 該 Status 屬性的值。
此方法在任務中儲存所有非使用例外，該方法的同步對應程式可拋出這些例外。 如果回傳的任務中儲存了例外，該例外會在等待任務時拋出。 使用例外錯誤，例如 ArgumentException，仍會同步拋出。 關於儲存的例外，請參見由 Write(Byte[], Int32, Int32)拋出的例外。
