RandomAccess.Read 方法

定義

命名空間:

System.IO

組件:

System.Runtime.dll

多載

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

Read(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64)

來源:

RandomAccess.cs

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

public:
 static long Read(Microsoft::Win32::SafeHandles::SafeFileHandle ^ handle, System::Collections::Generic::IReadOnlyList<Memory<System::Byte>> ^ buffers, long fileOffset);

public static long Read (Microsoft.Win32.SafeHandles.SafeFileHandle handle, System.Collections.Generic.IReadOnlyList<Memory<byte>> buffers, long fileOffset);

static member Read : Microsoft.Win32.SafeHandles.SafeFileHandle * System.Collections.Generic.IReadOnlyList<Memory<byte>> * int64 -> int64

Public Shared Function Read (handle As SafeFileHandle, buffers As IReadOnlyList(Of Memory(Of Byte)), fileOffset As Long) As Long

參數

handle

SafeFileHandle

檔句柄。

buffers

IReadOnlyList<Memory<Byte>>

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

fileOffset

Int64

要讀取的檔案位置。

傳回

Int64

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

例外狀況

ArgumentNullException

handle 或 buffers 為 null。

ArgumentException

handle 無效。

ObjectDisposedException

檔案已關閉。

NotSupportedException

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

ArgumentOutOfRangeException

fileOffset 為負。

UnauthorizedAccessException

handle 未開啟以供讀取。

IOException

發生 I/O 錯誤。

備註

檔案的位置不是進階的。

Read(SafeFileHandle, Span<Byte>, Int64)

來源:

RandomAccess.cs

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

public:
 static int Read(Microsoft::Win32::SafeHandles::SafeFileHandle ^ handle, Span<System::Byte> buffer, long fileOffset);

public static int Read (Microsoft.Win32.SafeHandles.SafeFileHandle handle, Span<byte> buffer, long fileOffset);

static member Read : Microsoft.Win32.SafeHandles.SafeFileHandle * Span<byte> * int64 -> int

Public Shared Function Read (handle As SafeFileHandle, buffer As Span(Of Byte), fileOffset As Long) As Integer

參數

handle

SafeFileHandle

檔句柄。

buffer

Span<Byte>

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

fileOffset

Int64

要讀取的檔案位置。

傳回

Int32

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

例外狀況

ArgumentNullException

handle 為 null。

ArgumentException

handle 無效。

ObjectDisposedException

檔案已關閉。

NotSupportedException

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

ArgumentOutOfRangeException

fileOffset 為負。

UnauthorizedAccessException

handle 未開啟以供讀取。

IOException

發生 I/O 錯誤。

備註

檔案的位置不是進階的。