IsolatedStorageFileStream.Read Metoda

Definicja

Przeciążenia

Read(Byte[], Int32, Int32)

Kopiuje bajty z bieżącego buforowanego IsolatedStorageFileStream obiektu do tablicy typu Byte.Copies bytes from the current buffered IsolatedStorageFileStream object to a byte array.

Read(Span<Byte>)

Kopiuje bajty z bieżącego buforowanego IsolatedStorageFileStream obiektu do zakresu bajtów.Copies bytes from the current buffered IsolatedStorageFileStream object to a byte span.

Read(Byte[], Int32, Int32)

Kopiuje bajty z bieżącego buforowanego IsolatedStorageFileStream obiektu do tablicy typu Byte.Copies bytes from the current buffered IsolatedStorageFileStream object to a byte array.

public:
 override int Read(cli::array <System::Byte> ^ buffer, int offset, int count);
public override int Read (byte[] buffer, int offset, int count);
override this.Read : byte[] * int * int -> int
Public Overrides Function Read (buffer As Byte(), offset As Integer, count As Integer) As Integer

Parametry

buffer
Byte[]

Bufor, w którym mają zostać zapisane dane.The buffer to write the data into.

offset
Int32

Przesunięcie w buforze, od którego ma się zacząć pisać.The offset in the buffer at which to begin writing.

count
Int32

Maksymalna liczba bajtów do odczytania.The maximum number of bytes to read.

Zwraca

Int32

Całkowita liczba bajtów odczytanych do buffer .The total number of bytes read into the buffer. Wartość ta może być mniejsza niż liczba bajtów żądana, jeśli wiele bajtów nie jest obecnie dostępna lub zero, jeśli osiągnięto koniec strumienia.This can be less than the number of bytes requested if that many bytes are not currently available, or zero if the end of the stream is reached.

Uwagi

bufferParametr może być wystąpieniem Buffer klasy lub tablicą jednego z następujących typów: Byte , SByte , Char ,, Int16 Int32 , Int64 , UInt16 ,,, UInt32 UInt64 Single lub Double .The buffer parameter can be an instance of the Buffer class, or an array of one of the following types: Byte, SByte, Char, Int16, Int32, Int64, UInt16, UInt32, UInt64, Single, or Double.

Jeśli operacja odczytu zakończy się pomyślnie, bieżąca pozycja strumienia jest zaawansowana przez liczbę odczytanych bajtów.If the read operation is successful, the current position of the stream is advanced by the number of bytes read. Jeśli wystąpi wyjątek, bieżąca pozycja strumienia nie jest zmieniana.If an exception occurs, the current position of the stream is unchanged.

ReadMetoda traktuje buffer parametr jako blok bajtów, niezależnie od jego rzeczywistego typu.The Read method treats the buffer parameter as a block of bytes, regardless of its actual type. Podobnie offset count Parametry i są zawsze określone w bajtach.Likewise, the offset and count parameters are always specified in bytes. W przypadku buffer parametrów innych niż tablice bajtowe oznacza to, że indeks elementu lub liczba elementów musi być pomnożona przez rozmiar elementu w bajtach, aby utworzyć poprawną wartość dla offset lub count .For buffer parameters other than byte arrays, this means that an element index or the number of elements must be multiplied by the element size in bytes to form a correct value for offset or count.

ReadMetoda zwróci wartość zero tylko wtedy, gdy osiągnięto koniec strumienia.The Read method will return zero only if the end of the stream is reached. We wszystkich innych przypadkach Read zawsze odczytuje co najmniej jeden bajt ze strumienia przed zwróceniem.In all other cases, Read always reads at least one byte from the stream before returning. Jeśli nie są dostępne żadne dane z IsolatedStorageFileStream obiektu po wywołaniu Read metody, Metoda zostanie zablokowanie do momentu zwrócenia co najmniej jednego bajtu danych.If no data is available from the IsolatedStorageFileStream object upon a call to Read, the method will block until at least one byte of data can be returned.

Dotyczy

Read(Span<Byte>)

Kopiuje bajty z bieżącego buforowanego IsolatedStorageFileStream obiektu do zakresu bajtów.Copies bytes from the current buffered IsolatedStorageFileStream object to a byte span.

public:
 override int Read(Span<System::Byte> buffer);
public override int Read (Span<byte> buffer);
override this.Read : Span<byte> -> int
Public Overrides Function Read (buffer As Span(Of Byte)) As Integer

Parametry

buffer
Span<Byte>

Bufor, w którym mają zostać zapisane dane.The buffer to write the data into.

Zwraca

Int32

Całkowita liczba bajtów odczytanych do buffer .The total number of bytes read into the buffer. Wartość ta może być mniejsza niż liczba bajtów żądana, jeśli wiele bajtów nie jest obecnie dostępna lub zero, jeśli osiągnięto koniec strumienia.This can be less than the number of bytes requested if that many bytes are not currently available, or zero if the end of the stream is reached.

Dotyczy