Stream 클래스

2013-12-13

바이트 시퀀스에 대한 일반 뷰를 제공합니다.

Namespace:  System.IO
어셈블리:  mscorlib(mscorlib.dll)

public abstract class Stream : IDisposable

Stream 형식에서는 다음과 같은 멤버를 노출합니다.

  이름설명
Protected 메서드StreamStream 클래스의 새 인스턴스를 초기화합니다.
맨 위

  이름설명
Public 속성CanRead파생 클래스에서 재정의된 경우 현재 스트림이 읽기를 지원하는지 여부를 나타내는 값을 가져옵니다.
Public 속성CanSeek파생 클래스에서 재정의된 경우 현재 스트림이 검색을 지원하는지 여부를 나타내는 값을 가져옵니다.
Public 속성CanTimeout현재 스트림이 시간 초과될 수 있는지 여부를 결정하는 값을 가져옵니다.
Public 속성CanWrite파생 클래스에서 재정의된 경우 현재 스트림이 쓰기를 지원하는지 여부를 나타내는 값을 가져옵니다.
Public 속성Length파생 클래스에서 재정의된 경우 스트림 바이트의 길이를 가져옵니다.
Public 속성Position파생 클래스에서 재정의되면 현재 스트림 내의 위치를 가져오거나 설정합니다.
Public 속성ReadTimeout스트림 읽기 시도가 만료되기 전까지 기다릴 시간을 결정하는 값을 밀리초 단위로 가져오거나 설정합니다.
Public 속성WriteTimeout스트림 쓰기 시도가 만료되기 전까지 기다릴 시간을 결정하는 값을 밀리초 단위로 가져오거나 설정합니다.
맨 위

  이름설명
Public 메서드BeginRead비동기 읽기 작업을 시작합니다.
Public 메서드BeginWrite비동기 쓰기 작업을 시작합니다.
Public 메서드Close현재 스트림을 닫고 현재 스트림과 관련된 소켓과 파일 핸들 등의 리소스를 모두 해제합니다.
Public 메서드CopyTo(Stream)현재 스트림에서 모든 바이트를 읽어 대상 스트림에 씁니다.
Public 메서드CopyTo(Stream, Int32)현재 스트림에서 모든 바이트를 읽어 지정된 버퍼 크기로 대상 스트림에 씁니다.
Public 메서드CopyToAsync(Stream)현재 스트림에서 비동기적으로 바이트를 읽은 후 다른 스트림에 씁니다.
Public 메서드CopyToAsync(Stream, Int32)현재 스트림에서 바이트를 비동기적으로 읽은 다음 지정된 버퍼 크기로 다른 스트림에 씁니다.
Public 메서드CopyToAsync(Stream, Int32, CancellationToken)현재 스트림에서 바이트를 비동기적으로 읽은 다음 지정된 버퍼 크기 및 취소 토큰을 사용하여 다른 스트림에 씁니다.
Public 메서드Dispose()Stream에서 사용하는 모든 리소스를 해제합니다.
Protected 메서드Dispose(Boolean)Stream에서 사용하는 관리되지 않는 리소스를 해제하고, 관리되는 리소스를 선택적으로 해제할 수 있습니다.
Public 메서드EndRead보류 중인 비동기 읽기가 완료되기를 기다립니다.
Public 메서드EndWrite비동기 쓰기 작업을 끝냅니다.
Public 메서드Equals(Object)지정한 Object가 현재 Object와 같은지 확인합니다. (Object에서 상속됨)
Protected 메서드Finalize가비지 수집기에서 Object를 회수하기 전에 개체가 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다. (Object에서 상속됨)
Public 메서드Flush파생 클래스에서 재정의된 경우 이 스트림에 대해 모든 버퍼를 지우고 버퍼링된 데이터가 내부 장치에 쓰여지도록 합니다.
Public 메서드FlushAsync()이 스트림에 대한 모든 버퍼를 비동기적으로 지우고 버퍼링된 모든 데이터가 내부 장치에 쓰여지도록 합니다.
Public 메서드FlushAsync(CancellationToken)이 스트림에 대한 모든 버퍼를 비동기적으로 지우고 버퍼링된 모든 데이터가 내부 장치에 쓰여지도록 하고, 취소 요청을 모니터링합니다.
Public 메서드GetHashCode특정 형식에 대한 해시 함수 역할을 합니다. (Object에서 상속됨)
Public 메서드GetType현재 인스턴스의 Type을 가져옵니다. (Object에서 상속됨)
Protected 메서드MemberwiseClone현재 Object의 단순 복사본을 만듭니다. (Object에서 상속됨)
Public 메서드Read파생 클래스에서 재정의된 경우 현재 스트림에서 바이트의 시퀀스를 읽고 읽은 바이트 수만큼 스트림 내에서 앞으로 이동합니다.
Public 메서드ReadAsync(Byte[], Int32, Int32)현재 스트림에서 바이트 시퀀스를 비동기적으로 읽고 읽은 바이트 수만큼 스트림에서 위치를 앞으로 이동합니다.
Public 메서드ReadAsync(Byte[], Int32, Int32, CancellationToken)현재 스트림에서 바이트 시퀀스를 비동기적으로 읽고, 읽은 바이트 수만큼 스트림에서 위치를 앞으로 이동하고, 취소 요청을 모니터링합니다.
Public 메서드ReadByte스트림에서 바이트를 읽고 스트림 내 위치를 한 바이트씩 앞으로 이동하거나 스트림 끝일 경우 -1을 반환합니다.
Public 메서드Seek파생 클래스를 재정의될 때 현재 스트림 내의 위치를 설정합니다.
Public 메서드SetLength파생 클래스에 재정의될 때 현재 스트림의 길이를 설정합니다.
Public 메서드ToString현재 개체를 나타내는 문자열을 반환합니다. (Object에서 상속됨)
Public 메서드Write파생 클래스를 재정의될 때 현재 스트림에 바이트의 시퀀스를 쓰고 써진 바이트 수만큼 이 스트림 내에서 앞으로 이동합니다.
Public 메서드WriteAsync(Byte[], Int32, Int32)현재 스트림에 바이트 시퀀스를 비동기적으로 쓰고 쓴 바이트 수만큼 이 스트림에서 현재 위치를 앞으로 이동합니다.
Public 메서드WriteAsync(Byte[], Int32, Int32, CancellationToken)현재 스트림에 바이트 시퀀스를 비동기적으로 쓰고, 쓴 바이트 수만큼 이 스트림에서 현재 위치를 앞으로 이동하고, 취소 요청을 모니터링합니다.
Public 메서드WriteByte스트림의 현재 위치에 바이트를 쓰고 스트림 내 위치를 1바이트씩 앞으로 이동합니다.
맨 위

  이름설명
Public 확장 메서드AsInputStreamWindows 스토어 앱용 .NET의 관리되는 스트림을 Windows 런타임의 입력 스트림으로 변환합니다. (WindowsRuntimeStreamExtensions에서 정의됨)
Public 확장 메서드AsOutputStreamWindows 스토어 앱용 .NET의 관리되는 스트림을 Windows 런타임의 출력 스트림으로 변환합니다. (WindowsRuntimeStreamExtensions에서 정의됨)
맨 위

  이름설명
Public 필드정적 멤버Null백업 저장소가 없는 Stream입니다.
맨 위

스트림에는 다음의 세 가지 기본 작업이 포함됩니다.

  1. 스트림에서 읽을 수 있습니다. 읽기는 스트림의 데이터를 바이트 배열 같은 데이터 구조로 전송하는 것입니다.

  2. 스트림에 쓸 수 있습니다. 쓰기는 데이터 구조체에서 스트림으로 데이터를 전송하는 과정입니다.

  3. 스트림은 검색을 지원할 수 있습니다. 검색은 스트림 내에서 현재 위치를 쿼리하고 수정하는 과정입니다. 검색 기능은 스트림에 있는 백업 저장소의 종류에 따라 다릅니다. 예를 들어, 네트워크 스트림에는 현재 위치의 통합 개념이 없으므로 일반적으로 검색을 지원하지 않습니다.

Stream은 모든 스트림의 추상 기본 클래스입니다. 스트림은 파일, 입력/출력 장치, 프로세스 간 통신 파이프 또는 TCP/IP 소켓과 같은 바이트 시퀀스를 추상적으로 나타낸 것입니다. Stream 클래스와 해당 파생 클래스는 이러한 다른 형식의 입력 및 출력에 대한 일반 뷰를 제공하여 프로그래머를 운영 체제와 내부 장치의 세부 사항으로부터 격리시킵니다.

내부 데이터 소스 또는 리포지토리에 따라 스트림에서 이러한 기능 중 일부만 지원할 수도 있습니다. 응용프로그램에서 CanRead, CanWriteCanSeek 속성을 사용하여 해당 기능에 대한 스트림을 쿼리할 수 있습니다.

ReadWrite 메서드는 다양한 형식의 데이터를 읽고 씁니다. 검색을 지원하는 스트림의 경우 SeekSetLength 메서드와 PositionLength 속성을 사용하여 스트림의 현재 위치와 길이를 쿼리하고 수정합니다.

일부 스트림을 구현하면 내부 데이터에 대한 로컬 버퍼링이 실행되어 성능이 향상됩니다. 이러한 스트림에서는 Flush 메서드를 사용하여 내부 버퍼를 모두 지우고 모든 데이터가 내부 데이터 소스 또는 리포지토리에 쓰여졌는지 확인할 수 있습니다.

Stream에서 Close를 호출하면 Flush가 호출되면서 버퍼링된 데이터가 모두 플러시됩니다. 또한 Close는 내부 버퍼링에 사용되는 파일 핸들, 네트워크 연결 또는 메모리 같은 운영 체제 리소스를 해제합니다.

백업 저장소(비트 버킷)가 없는 스트림이 필요한 경우 Null을 사용합니다.

구현자 참고 사항

Stream의 파생 클래스를 구현할 때 ReadWrite 메서드에 대한 구현을 제공해야 합니다. 비동기 메서드 BeginRead, EndRead, BeginWriteEndWrite는 동기 메서드 ReadWrite를 통해 구현됩니다. 마찬가지로 ReadWrite의 구현은 비동기화 메서드에서 제대로 작동합니다. ReadByteWriteByte를 구현하면 기본적으로 새로운 단일 요소의 바이트 배열이 생성된 다음 ReadWrite의 구현이 호출됩니다. Stream에서 파생할 때 내부 바이트 버퍼가 있는 경우 성능을 향상시키려면 이러한 메서드를 재정의하여 내부 버퍼에 액세스하는 것이 좋습니다. 또한 CanRead, CanSeek, CanWrite, Flush, Length, Position, SeekSetLength를 구현해야 합니다.

Close 메서드를 재정의하는 대신 모든 Stream 정리 논리를 Dispose 메서드에 포함하세요.

TopicLocation
방법: 파일에 텍스트 쓰기.NET Framework: Programming Fundamentals
방법: 파일의 텍스트 읽기.NET Framework: Programming Fundamentals
방법: 파일에 텍스트 쓰기.NET Framework: 프로그래밍 기본 사항
방법: 파일의 텍스트 읽기.NET Framework: 프로그래밍 기본 사항

Windows Phone OS

지원되는 버전: 8.0, 7.1, 7.0

Windows Phone

이 형식의 모든 공용 static(Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 모든 인스턴스 멤버는 스레드로부터 안전하지 않을 수 있습니다.

표시:
© 2014 Microsoft