RandomAccess.ReadAsync Metoda
Definicja
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
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
handle lub buffers ma wartość null.
Nazwa handle jest niepoprawna.
Plik jest zamknięty.
Plik nie obsługuje wyszukiwania (potoku lub gniazda).
fileOffset jest ujemna.
handle nie został otwarty do czytania.
Wystąpił błąd we/wy.
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.
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
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.
Wyjątki
handle to null.
Nazwa handle jest niepoprawna.
Plik jest zamknięty.
Plik nie obsługuje wyszukiwania (potoku lub gniazda).
fileOffset jest ujemna.
handle nie został otwarty do czytania.
Wystąpił błąd we/wy.
Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.
Uwagi
Pozycja pliku nie jest zaawansowana.
