RandomAccess.ReadAsync 方法

定義

多載

ReadAsync(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64, CancellationToken)

從指定檔案讀取指定位移處的位元組序列。

ReadAsync(SafeFileHandle, Memory<Byte>, Int64, CancellationToken)

從指定檔案讀取指定位移處的位元組序列。

ReadAsync(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64, CancellationToken)

從指定檔案讀取指定位移處的位元組序列。

public static System.Threading.Tasks.ValueTask<long> ReadAsync (Microsoft.Win32.SafeHandles.SafeFileHandle handle, System.Collections.Generic.IReadOnlyList<Memory<byte>> buffers, long fileOffset, System.Threading.CancellationToken cancellationToken = default);
static member ReadAsync : Microsoft.Win32.SafeHandles.SafeFileHandle * System.Collections.Generic.IReadOnlyList<Memory<byte>> * int64 * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int64>
Public Shared Function ReadAsync (handle As SafeFileHandle, buffers As IReadOnlyList(Of Memory(Of Byte)), fileOffset As Long, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Long)

參數

handle
SafeFileHandle

檔案控制代碼。

buffers
IReadOnlyList<Memory<Byte>>

記憶體緩衝區的清單。 當這個方法傳回時,這些緩衝區的內容會由從檔案讀取的位元組取代。

fileOffset
Int64

要讀取的檔案位置。

cancellationToken
CancellationToken

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

傳回

ValueTask<Int64>

讀取到緩衝區的位元組總數。 如果目前無法使用許多位元組,則這可以小於緩衝區中配置的位元組數目,如果已到達檔案結尾,則為零 (0) 。

例外狀況

handlebuffersnull

handle 無效。

檔案已關閉。

檔案不支援搜尋 (管道或通訊端) 。

fileOffset 為負。

handle 未開啟以供讀取。

發生 I/O 錯誤。

備註

檔案的位置不是進階的。

適用於

ReadAsync(SafeFileHandle, Memory<Byte>, Int64, CancellationToken)

從指定檔案讀取指定位移處的位元組序列。

public static System.Threading.Tasks.ValueTask<int> ReadAsync (Microsoft.Win32.SafeHandles.SafeFileHandle handle, Memory<byte> buffer, long fileOffset, System.Threading.CancellationToken cancellationToken = default);
static member ReadAsync : Microsoft.Win32.SafeHandles.SafeFileHandle * Memory<byte> * int64 * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>
Public Shared Function ReadAsync (handle As SafeFileHandle, buffer As Memory(Of Byte), fileOffset As Long, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

參數

handle
SafeFileHandle

檔案控制代碼。

buffer
Memory<Byte>

記憶體區域。 當這個方法傳回時,這個區域的內容會由從檔案讀取的位元組取代。

fileOffset
Int64

要讀取的檔案位置。

cancellationToken
CancellationToken

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

傳回

ValueTask<Int32>

緩衝區所讀取的總位元組數。 如果目前無法使用許多位元組,則這可以小於緩衝區中配置的位元組數目,如果已到達檔案結尾,則為零 (0) 。

例外狀況

handlenull

handle 無效。

檔案已關閉。

檔案不支援搜尋 (管道或通訊端) 。

fileOffset 為負。

handle 未開啟以供讀取。

發生 I/O 錯誤。

備註

檔案的位置不是進階的。

適用於