Stream.Read 메서드

정의

오버로드

Read(Span<Byte>)

파생 클래스에서 재정의되면 현재 스트림에서 바이트의 시퀀스를 읽고, 읽은 바이트 수만큼 스트림 내에서 앞으로 이동합니다.

Read(Byte[], Int32, Int32)

파생 클래스에서 재정의되면 현재 스트림에서 바이트의 시퀀스를 읽고, 읽은 바이트 수만큼 스트림 내에서 앞으로 이동합니다.

Read(Span<Byte>)

파생 클래스에서 재정의되면 현재 스트림에서 바이트의 시퀀스를 읽고, 읽은 바이트 수만큼 스트림 내에서 앞으로 이동합니다.

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

매개 변수

buffer
Span<Byte>

메모리 영역입니다. 이 메서드가 반환될 때 이 영역의 내용은 현재 소스에서 읽은 바이트로 대체됩니다.

반환

버퍼로 읽어온 총 바이트 수입니다. 현재 많은 바이트를 사용할 수 없는 경우 버퍼 크기보다 작거나 버퍼의 길이가 0이거나 스트림 끝에 도달한 경우 0(0)일 수 있습니다.

설명

CanRead 현재 instance 읽기를 지원하는지 여부를 확인하려면 속성을 사용합니다. 메서드를 ReadAsync 사용하여 현재 스트림에서 비동기적으로 읽습니다.

이 메서드의 구현은 현재 스트림에서 최대 buffer.Length 바이트를 읽고 에 buffer저장합니다. 스트림 내의 현재 위치는 읽은 바이트 수만큼 고급입니다. 그러나 예외가 발생하면 스트림 내의 현재 위치는 변경되지 않은 상태로 유지됩니다. 구현은 읽은 바이트 수를 반환합니다. 0바이트 이상이 요청되면 하나 이상의 데이터를 읽을 수 있을 때까지 구현이 작업을 완료하지 않습니다(0바이트가 요청된 경우 하나 이상의 바이트를 사용할 수 있을 때까지 일부 구현이 유사하게 완료되지 않을 수 있지만 이러한 경우 스트림에서 데이터가 사용되지 않음). Read 는 0바이트가 요청되었거나 스트림에 더 이상 데이터가 없고 더 이상 필요하지 않은 경우에만 0을 반환합니다(예: 닫힌 소켓 또는 파일의 끝). 구현은 스트림의 끝에 도달하지 않은 경우에도 요청된 것보다 적은 바이트를 반환할 수 있습니다.

기본 데이터 형식을 읽는 데 사용합니다 BinaryReader .

적용 대상

Read(Byte[], Int32, Int32)

파생 클래스에서 재정의되면 현재 스트림에서 바이트의 시퀀스를 읽고, 읽은 바이트 수만큼 스트림 내에서 앞으로 이동합니다.

public:
 abstract int Read(cli::array <System::Byte> ^ buffer, int offset, int count);
public abstract int Read (byte[] buffer, int offset, int count);
abstract member Read : byte[] * int * int -> int
Public MustOverride Function Read (buffer As Byte(), offset As Integer, count As Integer) As Integer

매개 변수

buffer
Byte[]

바이트 배열입니다. 이 메서드는 지정된 바이트 배열의 값이 offset과 (offset + count - 1) 사이에서 현재 원본으로부터 읽어온 바이트로 교체된 상태로 반환됩니다.

offset
Int32

현재 스트림에서 읽은 데이터를 저장하기 시작하는 buffer의 바이트 오프셋(0부터 시작)입니다.

count
Int32

현재 스트림에서 읽을 최대 바이트 수입니다.

반환

버퍼로 읽어온 총 바이트 수입니다. 이는 현재 많은 바이트를 사용할 수 없는 경우 요청된 바이트 수보다 작을 수 있고, 가 0이거나 스트림의 끝에 도달한 경우 count 0일 수 있습니다.

예외

offsetcount의 합계가 버퍼 길이보다 큽니다.

buffer이(가) null인 경우

offset 또는 count가 음수입니다.

I/O 오류가 발생했습니다.

스트림이 읽기를 지원하지 않습니다.

스트림이 닫힌 후에 메서드가 호출되었습니다.

예제

다음 예제에서는 를 사용하여 Read 데이터 블록을 읽는 방법을 보여줍니다.

using namespace System;
using namespace System::IO;

public ref class Block
{
public:
    static void Main()
    {
        Stream^ s = gcnew MemoryStream();
        for (int i = 0; i < 100; i++)
        {
            s->WriteByte((Byte)i);
        }
        s->Position = 0;

        // Now read s into a byte buffer.
        array<Byte>^ bytes = gcnew array<Byte>(s->Length);
        int numBytesToRead = (int) s->Length;
        int numBytesRead = 0;
        while (numBytesToRead > 0)
        {
            // Read may return anything from 0 to 10.
            int n = s->Read(bytes, numBytesRead, 10);
            // The end of the file is reached.
            if (n == 0)
            {
                break;
            }
            numBytesRead += n;
            numBytesToRead -= n;
        }
        s->Close();
        // numBytesToRead should be 0 now, and numBytesRead should
        // equal 100.
        Console::WriteLine("number of bytes read: {0:d}", numBytesRead);
    }
};

int main()
{
    Block::Main();
}
using System;
using System.IO;

public class Block
{
    public static void Main()
    {
        Stream s = new MemoryStream();
        for (int i = 0; i < 122; i++)
        {
            s.WriteByte((byte)i);
        }
        s.Position = 0;

        // Now read s into a byte buffer with a little padding.
        byte[] bytes = new byte[s.Length + 10];
        int numBytesToRead = (int)s.Length;
        int numBytesRead = 0;
        do
        {
            // Read may return anything from 0 to 10.
            int n = s.Read(bytes, numBytesRead, 10);
            numBytesRead += n;
            numBytesToRead -= n;
        } while (numBytesToRead > 0);
        s.Close();

        Console.WriteLine("number of bytes read: {0:d}", numBytesRead);
    }
}
Imports System.IO

Public Class Block
    Public Shared Sub Main()
        Dim s As Stream = New MemoryStream()
        For i As Integer = 0 To 121
            s.WriteByte(CType(i, Byte))
        Next i
        s.Position = 0

        ' Now read s into a byte buffer that is padded slightly.
        Dim bytes(s.Length + 10) As Byte
        Dim numBytesToRead As Integer = s.Length
        Dim numBytesRead As Integer = 0
        Dim n As Integer
        Do
            ' Read may return anything from 0 to 10.
            n = s.Read(bytes, numBytesRead, 10)
            ' The end of the file is reached.
            numBytesRead += n
            numBytesToRead -= n
        Loop While numBytesToRead > 0

        s.Close()
    
        Console.WriteLine("number of bytes read: {0:d}", numBytesRead)
    End Sub
End Class

설명

CanRead 현재 instance 읽기를 지원하는지 여부를 확인하려면 속성을 사용합니다. 메서드를 ReadAsync 사용하여 현재 스트림에서 비동기적으로 읽습니다.

이 메서드의 구현은 현재 스트림에서 최대 count 바이트를 읽고 부터 offsetbuffer 저장합니다. 스트림 내의 현재 위치는 읽은 바이트 수만큼 고급입니다. 그러나 예외가 발생하면 스트림 내의 현재 위치는 변경되지 않은 상태로 유지됩니다. 구현은 읽은 바이트 수를 반환합니다. 0바이트 이상이 요청되면 하나 이상의 데이터를 읽을 수 있을 때까지 구현이 작업을 완료하지 않습니다(0바이트가 요청된 경우에도 하나 이상의 바이트를 사용할 수 있을 때까지 일부 구현은 마찬가지로 완료되지 않을 수 있지만 이러한 경우 스트림에서 데이터가 사용되지 않음). Read 는 0바이트가 요청되었거나 스트림에 더 이상 데이터가 없고 더 이상 필요하지 않은 경우에만 0을 반환합니다(예: 닫힌 소켓 또는 파일의 끝). 구현은 스트림의 끝에 도달하지 않은 경우에도 요청된 것보다 적은 바이트를 반환할 수 있습니다.

기본 데이터 형식을 읽는 데 사용합니다 BinaryReader .

추가 정보

적용 대상