FileStream.Read 메서드

  • 참조

정의

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

오버로드

Read(Byte[], Int32, Int32)

스트림에서 바이트 블록을 읽어서 해당 데이터를 제공된 버퍼에 씁니다.
Read(Span<Byte>)

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

Read(Byte[], Int32, Int32)

스트림에서 바이트 블록을 읽어서 해당 데이터를 제공된 버퍼에 씁니다.

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

매개 변수

arraybuffer
Byte[]

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

offset
Int32

읽은 바이트를 넣을 array의 바이트 오프셋입니다.

count
Int32

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

반환

Int32

버퍼로 읽어온 총 바이트 수입니다. 이 바이트 수는 사용 가능한 바이트 수가 부족한 경우 요청된 바이트 수보다 작을 수 있으며, 스트림의 끝에 도달하면 0이 됩니다.

예외

ArgumentNullException

array이(가) null인 경우

ArgumentOutOfRangeException

offset 또는 count가 음수입니다.

NotSupportedException

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

IOException

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

ArgumentException

offset 및 count가 array에서 잘못된 범위를 설명하는 경우

ObjectDisposedException

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

예제

다음 예제에서는 a FileStream 의 내용을 읽고 다른 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.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

설명

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

매개 변수는 offset 읽기를 시작할 바이트 array 인(버퍼 인덱스)의 오프셋을 제공하고 매개 count 변수는 이 스트림에서 읽을 최대 바이트 수를 제공합니다. 반환된 값은 실제 읽은 바이트 수이거나 스트림 끝에 도달하면 0입니다. 읽기 작업이 성공하면 스트림의 현재 위치는 읽은 바이트 수만큼 진행됩니다. 예외가 발생하면 스트림의 현재 위치는 변경되지 않습니다.

이 메서드는 Read 스트림의 끝에 도달한 후에만 0을 반환합니다. 그렇지 않으면 Read 반환하기 전에 항상 스트림에서 하나 이상의 바이트를 읽습니다. 호출 Read시 스트림에서 사용할 수 있는 데이터가 없으면 하나 이상의 데이터가 반환될 때까지 메서드가 차단됩니다. 구현은 스트림의 끝에 도달하지 않은 경우에도 요청된 것보다 더 적은 바이트를 반환할 수 있습니다.

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

읽기 작업을 수행하는 스레드를 중단하지 마세요. 애플리케이션 스레드가 차단 해제 되 면 성공적으로 실행 하려면 나타날 수 있습니다 하지만 애플리케이션의 성능 및 안정성 중단 줄일 수 있습니다.

일반적인 파일 및 디렉터리 작업 목록은 일반적인 I/O 작업을 참조하세요.

추가 정보

적용 대상

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

매개 변수

buffer
Span<Byte>

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

반환

Int32

버퍼로 읽어온 총 바이트 수입니다. 많은 바이트가 현재 사용 가능하지 않은 경우 버퍼에 할당된 바이트 수보다 작을 수 있으며 스트림의 끝에 도달하면 0이 됩니다.

설명

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

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

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

적용 대상