RandomAccess.ReadAsync Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.IO

Zestaw:: System.Runtime.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Przeciążenia

ReadAsync(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64, CancellationToken)	Odczytuje sekwencję bajtów z danego pliku przy danym przesunięciu.
ReadAsync(SafeFileHandle, Memory<Byte>, Int64, CancellationToken)	Odczytuje sekwencję bajtów z danego pliku przy danym przesunięciu.

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

Źródło:: RandomAccess.cs

Źródło:: RandomAccess.cs

Źródło:: RandomAccess.cs

Odczytuje sekwencję bajtów z danego pliku przy danym przesunięciu.

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)

Parametry

handle: SafeFileHandle

Dojście do pliku.

buffers: IReadOnlyList<Memory<Byte>>

Lista buforów pamięci. Gdy ta metoda zwraca, zawartość tych buforów jest zastępowana przez bajty odczytane z pliku.

fileOffset: Int64

Położenie pliku do odczytania.

cancellationToken: CancellationToken

Token do monitorowania żądań anulowania. Wartość domyślna to None.

Zwraca

ValueTask<Int64>

Całkowita liczba bajtów odczytanych do buforów. Może to być mniejsza niż liczba bajtów przydzielonych w buforach, jeśli liczba bajtów nie jest obecnie dostępna lub zero (0), jeśli osiągnięto koniec pliku.

Wyjątki

ArgumentNullException

handle lub buffers ma wartość null.

ArgumentException

Nazwa handle jest niepoprawna.

ObjectDisposedException

Plik jest zamknięty.

NotSupportedException

Plik nie obsługuje wyszukiwania (potoku lub gniazda).

ArgumentOutOfRangeException

fileOffset jest ujemna.

UnauthorizedAccessException

handle nie został otwarty do czytania.

IOException

Wystąpił błąd we/wy.

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.

Uwagi

Pozycja pliku nie jest zaawansowana.

Ta metoda jest przechowywana w zadaniu, które zwraca wszystkie wyjątki nieużytowe, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwracanym zadaniu, ten wyjątek zostanie zgłoszony podczas oczekiwania zadania. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłoszone przez Read(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64)usługę .

Dotyczy

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

Źródło:: RandomAccess.cs

Źródło:: RandomAccess.cs

Źródło:: RandomAccess.cs

Odczytuje sekwencję bajtów z danego pliku przy danym przesunięciu.

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)

Parametry

handle: SafeFileHandle

Dojście do pliku.

buffer: Memory<Byte>

Region pamięci. Gdy ta metoda zwróci wartość , zawartość tego regionu jest zastępowana bajtami odczytanych z pliku.

fileOffset: Int64

Położenie pliku do odczytania.

cancellationToken: CancellationToken

Token do monitorowania żądań anulowania. Wartość domyślna to None.

Zwraca

ValueTask<Int32>

Całkowita liczba bajtów odczytanych do buforu. Może to być mniejsza niż liczba bajtów przydzielonych w buforze, jeśli liczba bajtów nie jest obecnie dostępna, lub zero (0), jeśli koniec pliku został osiągnięty.