次の方法で共有


RandomAccess.ReadAsync メソッド

定義

オーバーロード

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 です。

戻り値

バッファーに読み込まれるバイトの合計数。 この値は、バッファーに割り当てられたバイト数より小さくできます (そのバイト数が現在使用できない場合)。ファイルの末尾に達した場合は 0 になります。

例外

handle または buffersnull です。

handle が無効です。

ファイルは閉じられています。

ファイルはシーク (パイプまたはソケット) をサポートしていません。

fileOffset が負の値です。

handle が読み取り用に開かれていました。

I/O エラーが発生しました。

キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。

注釈

ファイルの位置は高度ではありません。

このメソッドは、メソッドの同期例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機されたときにスローされます。 などの 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)

パラメーター

handle
SafeFileHandle

ファイル ハンドル。

buffer
Memory<Byte>

メモリの領域。 このメソッドが戻ると、この領域の内容はファイルから読み取られたバイトに置き換えられます。

fileOffset
Int64

読み取るファイルの位置。

cancellationToken
CancellationToken

キャンセル要求を監視するためのトークン。 既定値は None です。

戻り値

バッファーに読み取られた合計バイト数。 この値は、バッファーに割り当てられたバイト数より小さくできます (そのバイト数が現在使用できない場合)。ファイルの末尾に達した場合は 0 になります。

例外

handlenullです。

handle が無効です。

ファイルは閉じられています。

ファイルはシーク (パイプまたはソケット) をサポートしていません。

fileOffset が負の値です。

handle が読み取り用に開かれていました。

I/O エラーが発生しました。

キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。

注釈

ファイルの位置は高度ではありません。

適用対象