RandomAccess.ReadAsync 方法

參考

定義

命名空間:: System.IO

組件:: System.Runtime.dll

重要

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

多載

ReadAsync(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64, CancellationToken)	從指定檔案讀取指定位移處的位元組序列。
ReadAsync(SafeFileHandle, Memory<Byte>, Int64, CancellationToken)	從指定檔案讀取指定位移處的位元組序列。

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

來源:: RandomAccess.cs

來源:: RandomAccess.cs

來源:: RandomAccess.cs

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

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) 。

例外狀況

ArgumentNullException

handle 或 buffers 為 null。

ArgumentException

handle 無效。

ObjectDisposedException

檔案已關閉。

NotSupportedException

檔案不支援搜尋 (管道或套接字) 。

ArgumentOutOfRangeException

fileOffset 為負。

UnauthorizedAccessException

handle 未開啟以供讀取。

IOException

發生 I/O 錯誤。

OperationCanceledException

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

備註

檔案的位置不是進階的。

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

適用於

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

來源:: RandomAccess.cs

來源:: RandomAccess.cs

來源:: RandomAccess.cs

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

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)