FileStream.Read FileStream.Read FileStream.Read FileStream.Read Method

Definition

Überlädt

Read(Byte[], Int32, Int32) Read(Byte[], Int32, Int32) Read(Byte[], Int32, Int32) Read(Byte[], Int32, Int32)

Liest einen Byteblock aus dem Stream und schreibt die Daten in einen angegebenen Puffer.Reads a block of bytes from the stream and writes the data in a given buffer.

Read(Span<Byte>) Read(Span<Byte>) Read(Span<Byte>) Read(Span<Byte>)

Read(Byte[], Int32, Int32) Read(Byte[], Int32, Int32) Read(Byte[], Int32, Int32) Read(Byte[], Int32, Int32)

Liest einen Byteblock aus dem Stream und schreibt die Daten in einen angegebenen Puffer.Reads a block of bytes from the stream and writes the data in a given buffer.

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

Parameter

array
Byte[]

Enthält nach dem Beenden dieser Methode das angegebene Bytearray mit den Werten zwischen offset und (offset + count - 1), die durch die aus der aktuellen Quelle gelesenen Bytes ersetzt wurden.When this method returns, contains the specified byte array with the values between offset and (offset + count - 1) replaced by the bytes read from the current source.

offset
Int32 Int32 Int32 Int32

Das Byteoffset in array, an dem die gelesenen Bytes platziert werden.The byte offset in array at which the read bytes will be placed.

count
Int32 Int32 Int32 Int32

Die maximale Anzahl der zu lesenden Bytes.The maximum number of bytes to read.

Gibt zurück

Die Gesamtanzahl der in den Puffer gelesenen Bytes.The total number of bytes read into the buffer. Dies kann weniger als die Anzahl der angeforderten Bytes sein, wenn diese Anzahl an Bytes derzeit nicht verfügbar ist, oder 0, wenn das Streamende erreicht ist.This might be less than the number of bytes requested if that number of bytes are not currently available, or zero if the end of the stream is reached.

Ausnahmen

offset oder count ist ein negativer Wert.offset or count is negative.

Lesevorgänge werden vom Stream nicht unterstützt.The stream does not support reading.

E/A-FehlerAn I/O error occurred.

offset und count bezeichnen einen ungültigen Bereich in array.offset and count describe an invalid range in array.

Es wurden Methoden aufgerufen, nachdem der Stream geschlossen wurde.Methods were called after the stream was closed.

Beispiele

Das folgende Beispiel liest den Inhalt aus einem FileStream und schreibt ihn in ein anderes FileStream.The following example reads the contents from a FileStream and writes it into another FileStream.

using System;
using System.IO;

class Test
{

public static void Main()
{
    // Specify a file to read from and to create.
    string pathSource = @"c:\tests\source.txt";
    string pathNew = @"c:\tests\newfile.txt";

    try
    {

        using (FileStream fsSource = new FileStream(pathSource,
            FileMode.Open, FileAccess.Read))
        {

            // Read the source file into a byte array.
            byte[] bytes = new byte[fsSource.Length];
            int numBytesToRead = (int)fsSource.Length;
            int numBytesRead = 0;
            while (numBytesToRead > 0)
            {
                // Read may return anything from 0 to numBytesToRead.
                int n = fsSource.Read(bytes, numBytesRead, numBytesToRead);

                // Break when the end of the file is reached.
                if (n == 0)
                    break;

                numBytesRead += n;
                numBytesToRead -= n;
            }
             numBytesToRead = bytes.Length;

            // Write the byte array to the other FileStream.
            using (FileStream fsNew = new FileStream(pathNew,
                FileMode.Create, FileAccess.Write))
            {
                fsNew.Write(bytes, 0, numBytesToRead);
            }
        }
    }
    catch (FileNotFoundException ioEx)
    {
        Console.WriteLine(ioEx.Message);
    }
}
}
Imports System
Imports System.IO
Class Test
    
Public Shared Sub Main()
    ' Specify a file to read from and to create.
    Dim pathSource As String = "c:\tests\source.txt"
    Dim pathNew As String = "c:\tests\newfile.txt"
    Try 
        Using fsSource As FileStream = New FileStream(pathSource, _
            FileMode.Open, FileAccess.Read)
            ' Read the source file into a byte array.
                Dim bytes() As Byte = New Byte((fsSource.Length) - 1) {}
                Dim numBytesToRead As Integer = CType(fsSource.Length,Integer)
                Dim numBytesRead As Integer = 0

                While (numBytesToRead > 0)
                    ' Read may return anything from 0 to numBytesToRead.
                    Dim n As Integer = fsSource.Read(bytes, numBytesRead, _
                        numBytesToRead)
                    ' Break when the end of the file is reached.
                    If (n = 0) Then
                        Exit While
                    End If
                    numBytesRead = (numBytesRead + n)
                    numBytesToRead = (numBytesToRead - n)

                End While
            numBytesToRead = bytes.Length

            ' Write the byte array to the other FileStream.
            Using fsNew As FileStream = New FileStream(pathNew, _
                FileMode.Create, FileAccess.Write)
                fsNew.Write(bytes, 0, numBytesToRead)
            End Using
        End Using
    Catch ioEx As FileNotFoundException
        Console.WriteLine(ioEx.Message)
    End Try
End Sub
End Class

Hinweise

Diese Methode überschreibt Read.This method overrides Read.

Die offset -Parameter gibt den Offset des Bytes in array (Pufferindex) gelesen werden soll, und die count -Parameter gibt die maximale Anzahl von Bytes, die aus diesem Stream gelesen werden.The offset parameter gives the offset of the byte in array (the buffer index) at which to begin reading, and the count parameter gives the maximum number of bytes to be read from this stream. Der zurückgegebene Wert ist die tatsächliche Anzahl der gelesenen Bytes oder 0 (null), wenn das Ende des Streams erreicht ist.The returned value is the actual number of bytes read, or zero if the end of the stream is reached. Wenn der Lesevorgang erfolgreich ist, ist die aktuelle Position im Stream um die Anzahl der gelesenen Bytes erweitert.If the read operation is successful, the current position of the stream is advanced by the number of bytes read. Wenn eine Ausnahme auftritt, wird die aktuelle Position des Streams unverändert.If an exception occurs, the current position of the stream is unchanged.

Die Read Methode gibt 0 (null) nur nach Erreichen das Ende des Streams zurück.The Read method returns zero only after reaching the end of the stream. Andernfalls Read immer mindestens ein Byte aus dem Stream liest, vor der Rückgabe.Otherwise, Read always reads at least one byte from the stream before returning. Wenn keine Daten verfügbar, aus dem Stream bei einem Aufruf von sind Read, die Methode blockiert, bis mindestens ein Byte an Daten zurückgegeben werden kann.If no data is available from the stream upon a call to Read, the method will block until at least one byte of data can be returned. Eine Implementierung ist weniger Bytes als angefordert zurückgeben, selbst wenn Sie nicht das Ende des Streams erreicht wurde.An implementation is free to return fewer bytes than requested even if the end of the stream has not been reached.

Verwendung BinaryReader zum Lesen von primitiven Datentypen.Use BinaryReader for reading primitive data types.

Unterbrechen Sie keinen Thread, der einen Lesevorgang ausführt.Do not interrupt a thread that is performing a read operation. Obwohl die Anwendung angezeigt werden kann, erfolgreich ausgeführt wird, nachdem der Thread nicht blockiert ist, kann die Unterbrechung, Leistung und Zuverlässigkeit Ihrer Anwendungsverzeichnis verringern.Although the application may appear to run successfully after the thread is unblocked, the interruption can decrease your application's performance and reliability.

Eine Liste der allgemeinen Datei- und Verzeichnisvorgänge, finden Sie unter e/a-Aufgaben.For a list of common file and directory operations, see Common I/O Tasks.

Siehe auch

Read(Span<Byte>) Read(Span<Byte>) Read(Span<Byte>) Read(Span<Byte>)

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

Parameter

buffer
Span<Byte>

Gibt zurück

Gilt für: