RandomAccess.Read Metoda

Definicja

Przeciążenia

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

Odczytuje sekwencję bajtów z danego pliku z danego przesunięcia.

Read(SafeFileHandle, Span<Byte>, Int64)

Odczytuje sekwencję bajtów z danego pliku z danego przesunięcia.

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

Źródło:
RandomAccess.cs
Źródło:
RandomAccess.cs
Źródło:
RandomAccess.cs

Odczytuje sekwencję bajtów z danego pliku z danego przesunięcia.

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

Parametry

handle
SafeFileHandle

Dojście do pliku.

buffers
IReadOnlyList<Memory<Byte>>

Lista buforów pamięci. Po powrocie tej metody zawartość buforów jest zastępowana bajtami odczytaną z pliku.

fileOffset
Int64

Pozycja pliku do odczytu.

Zwraca

Całkowita liczba bajtów odczytanych do buforów. Może to być mniej 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 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.

Uwagi

Pozycja pliku nie jest zaawansowana.

Dotyczy

Read(SafeFileHandle, Span<Byte>, Int64)

Źródło:
RandomAccess.cs
Źródło:
RandomAccess.cs
Źródło:
RandomAccess.cs

Odczytuje sekwencję bajtów z danego pliku z danego przesunięcia.

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

Parametry

handle
SafeFileHandle

Dojście do pliku.

buffer
Span<Byte>

Region pamięci. Po powrocie tej metody zawartość tego regionu jest zastępowana przez bajty odczytane z pliku.

fileOffset
Int64

Pozycja pliku do odczytu.

Zwraca

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

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.

Uwagi

Pozycja pliku nie jest zaawansowana.

Dotyczy