BufferedStream.Read Metoda

Definice

Obor názvů:

System.IO

Sestavení:

netstandard.dll, System.Runtime.dll

Přetížení

Name	Description
Read(Span<Byte>)	Zkopíruje bajty z aktuálního streamu ve vyrovnávací paměti do rozsahu bajtů a posune pozici v rámci streamu vyrovnávací paměti o počet přečtených bajtů.
Read(Byte[], Int32, Int32)	Zkopíruje bajty z aktuálního streamu ve vyrovnávací paměti do pole.

Read(Span<Byte>)

Zdroj:

BufferedStream.cs

Zkopíruje bajty z aktuálního streamu ve vyrovnávací paměti do rozsahu bajtů a posune pozici v rámci streamu vyrovnávací paměti o počet přečtených bajtů.

public:
 override int Read(Span<System::Byte> destination);

public override int Read(Span<byte> destination);

override this.Read : Span<byte> -> int

Public Overrides Function Read (destination As Span(Of Byte)) As Integer

Parametry

destination

Span<Byte>

Oblast paměti. Když tato metoda vrátí, obsah této oblasti se nahradí bajty načtenými z aktuálního zdroje.

Návraty

Int32

Celkový počet bajtů přečtených do vyrovnávací paměti. To může být menší než počet bajtů přidělených ve vyrovnávací paměti, pokud není aktuálně k dispozici mnoho bajtů, nebo nula (0), pokud bylo dosaženo konce datového proudu.

Poznámky

CanRead Pomocí vlastnosti určete, zda aktuální instance podporuje čtení. ReadAsync Pomocí metody můžete číst asynchronně z aktuálního datového proudu.

Implementace této metody čtou maximum buffer.Length bajtů z aktuálního datového proudu a ukládají je do buffer. Aktuální pozice v rámci datového proudu je rozšířena počtem přečtených bajtů; Pokud však dojde k výjimce, zůstane aktuální pozice v rámci datového proudu nezměněna. Implementace vrátí počet přečtených bajtů. Implementace bude blokovat, dokud nebude možné číst alespoň jeden bajt dat v případě, že nejsou k dispozici žádná data. Read vrátí hodnotu 0 pouze v případě, že v datovém proudu nejsou žádná další data a už se neočekává (například uzavřený soket nebo konec souboru). Implementace je zdarma vrátit méně bajtů, než je požadováno, i když nebyl dosažen konec datového proudu.

Slouží BinaryReader ke čtení primitivních datových typů.

Read(Byte[], Int32, Int32)

Zdroj:

BufferedStream.cs

Zkopíruje bajty z aktuálního streamu ve vyrovnávací paměti do pole.

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[]

offset

Int32

Posun bajtu ve vyrovnávací paměti, ve které se mají začít číst bajty.

count

Int32

Počet bajtů, které se mají přečíst.

Návraty

Int32

Celkový počet bajtů přečtených do array. Může to být menší než počet bajtů požadovaných v případě, že tento počet bajtů není aktuálně k dispozici, nebo 0, pokud bylo dosaženo konce datového proudu před načtením jakýchkoli dat.

Výjimky

ArgumentException

array Délka minus offset je menší než count.

ArgumentNullException

array je null.

ArgumentOutOfRangeException

offset nebo count je negativní.

IOException

Stream není otevřený nebo je null.

NotSupportedException

Stream nepodporuje čtení.

ObjectDisposedException

Metody byly volány po zavření datového proudu.

Příklady

Tento příklad kódu je součástí většího příkladu uvedeného pro třídu BufferedStream.

// Receive data using the BufferedStream.
Console.WriteLine("Receiving data using BufferedStream.");
bytesReceived = 0;
startTime = DateTime.Now;

int numBytesToRead = receivedData.Length;

while (numBytesToRead > 0)
{
    // Read may return anything from 0 to numBytesToRead.
    int n = bufStream.Read(receivedData,0, receivedData.Length);
    // The end of the file is reached.
    if (n == 0)
        break;
    bytesReceived += n;
    numBytesToRead -= n;
}

bufferedTime = (DateTime.Now - startTime).TotalSeconds;
Console.WriteLine("{0} bytes received in {1} seconds.\n",
    bytesReceived.ToString(),
    bufferedTime.ToString("F1"));

// Receive data using the BufferedStream.
printfn "Receiving data using BufferedStream."
bytesReceived <- 0
let startTime = DateTime.Now

let mutable numBytesToRead = receivedData.Length

let mutable broken = false
while not broken && numBytesToRead > 0 do
    // Read may return anything from 0 to numBytesToRead.
    let n = bufStream.Read(receivedData,0, receivedData.Length)
    // The end of the file is reached.
    if n = 0 then
        broken <- true
    else
        bytesReceived <- bytesReceived + n
        numBytesToRead <- numBytesToRead - n

let bufferedTime = (DateTime.Now - startTime).TotalSeconds
printfn $"{bytesReceived} bytes received in {bufferedTime:F1} seconds.\n"

' Receive data using the BufferedStream.
Console.WriteLine("Receiving data using BufferedStream.")
bytesReceived = 0
startTime = DateTime.Now

Dim numBytesToRead As Integer = receivedData.Length
Dim n As Integer
Do While numBytesToRead > 0

    'Read my return anything from 0 to numBytesToRead
    n = bufStream.Read(receivedData, 0, receivedData.Length)
    'The end of the file is reached.
    If n = 0 Then
        Exit Do
    End If

    bytesReceived += n
    numBytesToRead -= n
Loop

bufferedTime = DateTime.Now.Subtract(startTime).TotalSeconds
Console.WriteLine("{0} bytes received in {1} " & _
    "seconds." & vbCrLf, _
    bytesReceived.ToString(), _
    bufferedTime.ToString("F1"))

Poznámky

Metoda Read vrátí hodnotu 0 pouze v případě, že je dosaženo konce datového proudu. Ve všech ostatních případech Read vždy čte alespoň jeden bajt z datového proudu před vrácením. Podle definice, pokud nejsou k dispozici žádná data z datového proudu při volání Read, Read metoda vrátí hodnotu 0 (konec datového proudu je dosaženo automaticky). Implementace je zdarma vrátit méně bajtů, než je požadováno, i když nebyl dosažen konec datového proudu.

Slouží BinaryReader ke čtení primitivních datových typů.

Viz také

• BlockCopy(Array, Int32, Array, Int32, Int32)
• CanRead
• Write(Byte[], Int32, Int32)
• Vstup/výstup souborů a streamů
• Postupy: Čtení textu ze souboru
• Postupy: Zápis textu do souboru