RandomAccess.WriteAsync 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| WriteAsync(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64, CancellationToken) |
從給定緩衝區寫入一串位元組到指定偏移的檔案。 |
| WriteAsync(SafeFileHandle, ReadOnlyMemory<Byte>, Int64, CancellationToken) |
從指定緩衝區寫入一串位元組到指定偏移量的檔案。 |
WriteAsync(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64, CancellationToken)
從給定緩衝區寫入一串位元組到指定偏移的檔案。
public static System.Threading.Tasks.ValueTask WriteAsync(Microsoft.Win32.SafeHandles.SafeFileHandle handle, System.Collections.Generic.IReadOnlyList<ReadOnlyMemory<byte>> buffers, long fileOffset, System.Threading.CancellationToken cancellationToken = default);static member WriteAsync : Microsoft.Win32.SafeHandles.SafeFileHandle * System.Collections.Generic.IReadOnlyList<ReadOnlyMemory<byte>> * int64 * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTaskPublic Shared Function WriteAsync (handle As SafeFileHandle, buffers As IReadOnlyList(Of ReadOnlyMemory(Of Byte)), fileOffset As Long, Optional cancellationToken As CancellationToken = Nothing) As ValueTask參數
- handle
- SafeFileHandle
檔句柄。
- buffers
- IReadOnlyList<ReadOnlyMemory<Byte>>
一份記憶體緩衝區清單。 此方法會將這些緩衝區的內容複製到檔案中。
- fileOffset
- Int64
要寫入的檔案位置。
- cancellationToken
- CancellationToken
用來監控取消申請的代幣。 預設值為 None。
傳回
一個代表寫入操作非同步完成的任務。
例外狀況
handle 或 buffers 為 null。
handle 無效。
檔案已結案。
該檔案不支援尋址（管道或套接字）。
fileOffset 為負數。
handle 未開放書寫。
發生 I/O 錯誤。
取消令牌也被取消了。 此例外會儲存在回傳的任務中。
備註
檔案位置不前。
此方法在任務中儲存所有非使用例外，該方法的同步對應程式可拋出這些例外。 如果回傳的任務中儲存了例外，該例外會在等待任務時拋出。 使用例外錯誤，例如 ArgumentException，仍會同步拋出。 關於儲存的例外，請參見由 Write(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64)拋出的例外。
適用於
WriteAsync(SafeFileHandle, ReadOnlyMemory<Byte>, Int64, CancellationToken)
從指定緩衝區寫入一串位元組到指定偏移量的檔案。
public static System.Threading.Tasks.ValueTask WriteAsync(Microsoft.Win32.SafeHandles.SafeFileHandle handle, ReadOnlyMemory<byte> buffer, long fileOffset, System.Threading.CancellationToken cancellationToken = default);static member WriteAsync : Microsoft.Win32.SafeHandles.SafeFileHandle * ReadOnlyMemory<byte> * int64 * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTaskPublic Shared Function WriteAsync (handle As SafeFileHandle, buffer As ReadOnlyMemory(Of Byte), fileOffset As Long, Optional cancellationToken As CancellationToken = Nothing) As ValueTask參數
- handle
- SafeFileHandle
檔句柄。
- buffer
- ReadOnlyMemory<Byte>
一個記憶區域。 此方法會將該區域的內容複製到檔案中。
- fileOffset
- Int64
要寫入的檔案位置。
- cancellationToken
- CancellationToken
用來監控取消申請的代幣。 預設值為 None。
傳回
一個代表寫入操作非同步完成的任務。
例外狀況
handle 是 null。
handle 無效。
檔案已結案。
該檔案不支援尋址（管道或套接字）。
fileOffset 為負數。
handle 未開放書寫。
發生 I/O 錯誤。
取消令牌也被取消了。 此例外會儲存在回傳的任務中。
備註
檔案位置不前。
