RandomAccess.Read Metoda

Definicja

Przestrzeń nazw:

System.IO

Zestaw:

System.Runtime.dll

Przeciążenia

Nazwisko	Opis
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

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. Gdy ta metoda zwraca, zawartość buforów jest zastępowana przez bajty odczytane z pliku.

fileOffset

Int64

Położenie pliku do odczytania. W .NET 11 lub nowszych wersjach ten parametr jest ignorowany dla plików, które nie obsługują wyszukiwania, takich jak potoki, gniazda i urządzenia znakowe. Wartość musi być nieujemna nawet wtedy, gdy jest ignorowana.

Zwraca

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

handle jest nieprawidłowy.

ObjectDisposedException

Plik jest zamknięty.

NotSupportedException

W .NET 10 i starszych wersjach plik nie obsługuje wyszukiwania (na przykład potoku lub gniazda).

ArgumentOutOfRangeException

fileOffset jest ujemna.

UnauthorizedAccessException

handle nie został otwarty do czytania.

IOException

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

Uwagi

W przypadku plików, które obsługują wyszukiwanie, pozycja pliku nie jest zaawansowana.

Read(SafeFileHandle, Span<Byte>, Int64)

Ź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. Gdy ta metoda zwraca, zawartość tego regionu jest zastępowana przez bajty odczytane z pliku.

fileOffset

Int64

Położenie pliku do odczytania. W .NET 11 lub nowszych wersjach ten parametr jest ignorowany dla plików, które nie obsługują wyszukiwania, takich jak potoki, gniazda i urządzenia znakowe. Wartość musi być nieujemna nawet wtedy, gdy jest ignorowana.

Zwraca

Int32

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

ArgumentNullException

Parametr handle ma wartość null.

ArgumentException

handle jest nieprawidłowy.

ObjectDisposedException

Plik jest zamknięty.

NotSupportedException

W .NET 10 i starszych wersjach plik nie obsługuje wyszukiwania (na przykład potoku lub gniazda).

ArgumentOutOfRangeException

fileOffset jest ujemna.

UnauthorizedAccessException

handle nie został otwarty do czytania.

IOException

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

Uwagi

W przypadku plików, które obsługują wyszukiwanie, pozycja pliku nie jest zaawansowana.