StreamWriter 클래스

아티클
08/21/2007

TextWriter를 구현하여 특정 인코딩의 스트림에 문자를 씁니다.

네임스페이스: System.IO
어셈블리: mscorlib(mscorlib.dll)

구문

‘선언
<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public Class StreamWriter
    Inherits TextWriter
‘사용 방법
Dim instance As StreamWriter

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public class StreamWriter : TextWriter

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public ref class StreamWriter : public TextWriter

/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
public class StreamWriter extends TextWriter

SerializableAttribute 
ComVisibleAttribute(true) 
public class StreamWriter extends TextWriter

설명

StreamWriter는 특정 인코딩의 문자 출력을 위해 설계된 반면 Stream에서 파생된 클래스는 바이트 입력 및 출력을 위해 설계되었습니다.

다르게 지정되지 않은 경우 StreamWriter는 기본적으로 UTF8Encoding의 인스턴스를 사용합니다. UTF8Encoding의 이 인스턴스가 생성되어 Encoding.GetPreamble 메서드는 UTF-8로 작성된 유니코드 바이트 순서 표시를 반환합니다. 기존의 스트림에 추가하지 않는 경우 인코딩의 프리앰블이 스트림에 추가됩니다. 즉, StreamWriter로 만드는 텍스트 파일 맨 처음에는 세 개의 바이트 순서 표시가 나타납니다. UTF-8은 모든 유니코드 문자를 정확하게 처리하고 운영 체제의 지역화된 버전에 일관성 있는 결과를 제공합니다.

기본적으로 StreamWriter는 스레드로부터 안전하지 않습니다. 스레드로부터 안전한 래퍼에 대한 자세한 내용은 TextWriter.Synchronized를 참조하십시오.

다음 표에서는 일반적인 예 또는 관련된 I/O 작업의 예를 보여 줍니다.

수행 작업	참조 항목
텍스트 파일을 만듭니다.	방법: 파일에 텍스트 쓰기
텍스트 파일에 씁니다.	방법: 파일에 텍스트 쓰기
텍스트 파일에서 읽습니다.	방법: 파일의 텍스트 읽기
파일에 텍스트를 추가합니다.	방법: 로그 파일 열기 및 추가 File.AppendText FileInfo.AppendText
파일 크기를 가져옵니다.	FileInfo.Length
파일 특성을 가져옵니다.	File.GetAttributes
파일의 특성을 설정합니다.	File.SetAttributes
파일이 있는지 여부를 확인합니다.	File.Exists
이진 파일에서 읽습니다.	방법: 새로 만든 데이터 파일 읽기 및 쓰기
이진 파일에 씁니다.	방법: 새로 만든 데이터 파일 읽기 및 쓰기

상속 계층 구조

System.Object
   System.MarshalByRefObject
     System.IO.TextWriter
      System.IO.StreamWriter

스레드로부터의 안전성

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

플랫폼

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.

버전 정보

.NET Framework

2.0, 1.1, 1.0에서 지원

.NET Compact Framework

2.0, 1.0에서 지원

참고 항목

참조

StreamWriter 멤버
System.IO 네임스페이스
Stream 클래스
StreamReader 클래스
Encoder
Encoding

기타 리소스

파일 및 스트림 I/O
방법: 파일의 텍스트 읽기
방법: 파일에 텍스트 쓰기
기본 파일 I/O
방법: 새로 만든 데이터 파일 읽기 및 쓰기

다음을 통해 공유