MemoryStream.Read 메서드

정의

네임스페이스:
System.IO
어셈블리:
netstandard.dll, System.Runtime.dll
어셈블리:
System.Runtime.Extensions.dll
어셈블리:
netstandard.dll
어셈블리:
mscorlib.dll, System.IO.dll
어셈블리:
System.IO.dll
어셈블리:
mscorlib.dll

오버로드

Name Description
Read(Span<Byte>)

현재 메모리 스트림에서 바이트 시퀀스를 읽고 메모리 스트림 내의 위치를 읽은 바이트 수만큼 앞으로 이동합니다.
Read(Byte[], Int32, Int32)

현재 스트림에서 바이트 블록을 읽고 버퍼에 데이터를 씁니다.

Read(Span<Byte>)

Source:
MemoryStream.cs
Source:
MemoryStream.cs
Source:
MemoryStream.cs
Source:
MemoryStream.cs
Source:
MemoryStream.cs

현재 메모리 스트림에서 바이트 시퀀스를 읽고 메모리 스트림 내의 위치를 읽은 바이트 수만큼 앞으로 이동합니다.

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

매개 변수

destinationbuffer
Span<Byte>

메모리 영역입니다. 이 메서드가 반환되면 이 범위의 내용이 현재 메모리 스트림 원본에서 읽은 바이트로 바뀝니다.

반품

Int32

버퍼에 읽은 총 바이트 수입니다. 현재 많은 바이트를 사용할 수 없는 경우 버퍼에 할당된 바이트 수보다 작거나 메모리 스트림의 끝에 도달한 경우 0보다 작을 수 있습니다.

적용 대상

Read(Byte[], Int32, Int32)

Source:
MemoryStream.cs
Source:
MemoryStream.cs
Source:
MemoryStream.cs
Source:
MemoryStream.cs
Source:
MemoryStream.cs

현재 스트림에서 바이트 블록을 읽고 버퍼에 데이터를 씁니다.

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

매개 변수

buffer
Byte[]

이 메서드가 반환될 때 현재 스트림에서 읽은 문자로 바뀐 값과 (offsetoffset + - 1) 사이의 count 값을 가진 지정된 바이트 배열을 포함합니다.

offset
Int32

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

count
Int32

읽을 최대 바이트 수입니다.

반품

Int32

버퍼에 기록된 총 바이트 수입니다. 이는 해당 바이트 수를 현재 사용할 수 없는 경우 요청된 바이트 수보다 작거나, 바이트를 읽기 전에 스트림의 끝에 도달한 경우 0이 될 수 있습니다.

예외

ArgumentNullException

buffer은 null입니다.

ArgumentOutOfRangeException

offset 또는 count 음수입니다.

ArgumentException

offset 버퍼 길이에서 빼는 값이 .보다 count작습니다.

ObjectDisposedException

현재 스트림 인스턴스가 닫혔습니다.

예제

이 코드 예제는 클래스에 제공된 더 큰 예제의 MemoryStream 일부입니다.

// Read the first 20 bytes from the stream.
byteArray = new byte[memStream.Length];
count = memStream.Read(byteArray, 0, 20);

' Read the first 20 bytes from the stream.
byteArray = _
    New Byte(CType(memStream.Length, Integer)){}
count = memStream.Read(byteArray, 0, 20)

설명

이 메서드는 Read를 재정의합니다.

매개 변수는 offset 현재 스트림의 데이터가 기록되는 첫 번째 바이트의 buffer 오프셋을 제공합니다. 매개 변수는 count 현재 스트림에서 읽을 최대 바이트 수를 제공합니다. 반환된 값은 읽은 실제 바이트 수이거나 스트림의 끝에 도달하면 0입니다.

읽기 작업이 성공하면 스트림 내의 현재 위치가 읽은 바이트 수만큼 진행됩니다. 예외가 발생하면 스트림 내의 현재 위치는 변경되지 않은 상태로 유지됩니다.

이 메서드는 Read 스트림의 끝에 도달한 경우에만 0을 반환합니다. 다른 모든 경우에는 Read 반환하기 전에 항상 스트림에서 하나 이상의 바이트를 읽습니다. 정의에 따라 호출 ReadRead 시 스트림에서 사용할 수 있는 데이터가 없는 경우 메서드는 0을 반환합니다(스트림의 끝에 자동으로 도달). 구현은 스트림의 끝에 도달하지 않은 경우에도 요청된 것보다 적은 바이트를 반환할 수 있습니다.

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

Caution

매개 변수에 지정된 바이트 배열이 메서드에서 buffer 반환 GetBuffer 하는 기본 버퍼인 경우 배열 내용을 덮어쓰고 예외가 throw되지 않습니다.

추가 정보

적용 대상