정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

StreamWriter 클래스

2013-12-13

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

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

public class StreamWriter : TextWriter

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

  이름설명
Public 메서드StreamWriter(Stream)UTF-8 인코딩과 기본 버퍼 크기를 사용하는 지정된 스트림으로 StreamWriter 클래스의 새 인스턴스를 초기화합니다.
Public 메서드StreamWriter(String)기본 인코딩과 버퍼 크기를 사용하여 지정 경로의 지정 파일에 대한 StreamWriter 클래스의 새 인스턴스를 초기화합니다.
Public 메서드StreamWriter(Stream, Encoding)지정된 인코딩과 기본 버퍼 크기를 사용하여 지정된 스트림에 대한 StreamWriter 클래스의 새 인스턴스를 초기화합니다.
Public 메서드StreamWriter(String, Boolean)기본 인코딩과 버퍼 크기를 사용하여 지정 경로의 지정 파일에 대한 StreamWriter 클래스의 새 인스턴스를 초기화합니다. 해당 파일이 있으면 덮어쓰거나 추가합니다. 해당 파일이 없으면 이 생성자는 새 파일을 만듭니다.
Public 메서드StreamWriter(Stream, Encoding, Int32)지정된 인코딩과 버퍼 크기를 사용하여 지정된 스트림에 대한 StreamWriter 클래스의 새 인스턴스를 초기화합니다.
Public 메서드StreamWriter(String, Boolean, Encoding)지정된 인코딩과 기본 버퍼 크기를 사용하여 지정 경로의 지정 파일에 대한 StreamWriter 클래스의 새 인스턴스를 초기화합니다. 해당 파일이 있으면 덮어쓰거나 추가합니다. 해당 파일이 없으면 이 생성자는 새 파일을 만듭니다.
Public 메서드StreamWriter(Stream, Encoding, Int32, Boolean)지정된 인코딩, 버퍼 크기 및 스트림을 열어 둘 것인지를 지정하는 값을 사용하여 특정 스트림에 대해 StreamWriter 클래스의 새 인스턴스를 초기화합니다.
Public 메서드StreamWriter(String, Boolean, Encoding, Int32)지정된 인코딩과 버퍼 크기를 사용하여 지정 경로의 지정 파일에 대한 StreamWriter 클래스의 새 인스턴스를 초기화합니다. 해당 파일이 있으면 덮어쓰거나 추가합니다. 해당 파일이 없으면 이 생성자는 새 파일을 만듭니다.
맨 위

  이름설명
Public 속성AutoFlushStreamWriterStreamWriter.Write를 호출할 때마다 해당 버퍼를 내부 스트림에 플러시할지 여부를 나타내는 값을 가져오거나 설정합니다.
Public 속성BaseStream백업 저장소의 인터페이스 역할을 하는 내부 스트림을 가져옵니다.
Public 속성Encoding출력이 쓰여질 Encoding을 가져옵니다. (TextWriter.Encoding을(를) 재정의함)
Public 속성FormatProvider형식을 제어하는 개체를 가져옵니다. (TextWriter에서 상속됨)
Public 속성NewLine현재 TextWriter에서 사용한 줄 종결자 문자열을 가져오거나 설정합니다. (TextWriter에서 상속됨)
맨 위

  이름설명
Public 메서드Close현재 StreamWriter 개체 및 내부 스트림을 닫습니다. (TextWriter.Close()을(를) 재정의함)
Public 메서드Dispose()해당 TextWriter 개체에서 사용하는 리소스를 모두 해제합니다. (TextWriter에서 상속됨)
Protected 메서드Dispose(Boolean)StreamWriter에서 사용하는 관리되지 않는 리소스를 해제하고, 관리되는 리소스를 선택적으로 해제할 수 있습니다. (TextWriter.Dispose(Boolean)을(를) 재정의함)
Public 메서드Equals(Object)지정한 Object가 현재 Object와 같은지 확인합니다. (Object에서 상속됨)
Protected 메서드Finalize가비지 수집기에서 Object를 회수하기 전에 개체가 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다. (Object에서 상속됨)
Public 메서드Flush현재 writer의 모든 버퍼를 지우면 버퍼링된 모든 데이터가 내부 스트림에 쓰여집니다. (TextWriter.Flush()을(를) 재정의함)
Public 메서드FlushAsync이 스트림에 대한 모든 버퍼를 비동기적으로 지우고 버퍼링된 모든 데이터가 내부 장치에 쓰여지도록 합니다. (TextWriter.FlushAsync()을(를) 재정의함)
Public 메서드GetHashCode특정 형식에 대한 해시 함수 역할을 합니다. (Object에서 상속됨)
Public 메서드GetType현재 인스턴스의 Type을 가져옵니다. (Object에서 상속됨)
Protected 메서드MemberwiseClone현재 Object의 단순 복사본을 만듭니다. (Object에서 상속됨)
Public 메서드ToString현재 개체를 나타내는 문자열을 반환합니다. (Object에서 상속됨)
Public 메서드Write(Boolean)Boolean 값의 텍스트 표현을 텍스트 스트림에 씁니다. (TextWriter에서 상속됨)
Public 메서드Write(Char)스트림에 문자를 씁니다. (TextWriter.Write(Char)을(를) 재정의함)
Public 메서드Write(Char[])스트림에 문자 배열을 씁니다. (TextWriter.Write(Char[])을(를) 재정의함)
Public 메서드Write(Decimal)텍스트 스트림에 10진 값의 텍스트 표현을 씁니다. (TextWriter에서 상속됨)
Public 메서드Write(Double)텍스트 스트림에 8바이트 부동 소수점 값의 텍스트 표현을 씁니다. (TextWriter에서 상속됨)
Public 메서드Write(Int32)부호 있는 4바이트 정수의 텍스트 표현을 텍스트 스트림에 씁니다. (TextWriter에서 상속됨)
Public 메서드Write(Int64)부호 있는 8바이트 정수의 텍스트 표현을 텍스트 스트림에 씁니다. (TextWriter에서 상속됨)
Public 메서드Write(Object)개체에 대해 ToString을 호출하여 만들어진 개체의 텍스트 표현을 텍스트 스트림에 씁니다. (TextWriter에서 상속됨)
Public 메서드Write(Single)4바이트 부동 소수점 값의 텍스트 표현을 텍스트 스트림에 씁니다. (TextWriter에서 상속됨)
Public 메서드Write(String)스트림에 문자열을 씁니다. (TextWriter.Write(String)을(를) 재정의함)
Public 메서드Write(UInt32)부호 없는 4바이트 정수의 텍스트 표현을 텍스트 스트림에 씁니다. (TextWriter에서 상속됨)
Public 메서드Write(UInt64)부호 없는 8바이트 정수의 텍스트 표현을 텍스트 스트림에 씁니다. (TextWriter에서 상속됨)
Public 메서드Write(String, Object)String.Format과 같은 의미를 사용하여 서식이 지정된 문자열을 출력합니다. (TextWriter에서 상속됨)
Public 메서드Write(String, Object[])String.Format과 같은 의미를 사용하여 서식이 지정된 문자열을 출력합니다. (TextWriter에서 상속됨)
Public 메서드Write(Char[], Int32, Int32)스트림에 문자의 하위 배열을 씁니다. (TextWriter.Write(Char[], Int32, Int32)을(를) 재정의함)
Public 메서드Write(String, Object, Object)String.Format과 같은 의미를 사용하여 서식이 지정된 문자열을 출력합니다. (TextWriter에서 상속됨)
Public 메서드WriteAsync(Char)스트림에 비동기적으로 문자를 씁니다. (TextWriter.WriteAsync(Char)을(를) 재정의함)
Public 메서드WriteAsync(Char[])문자 배열을 비동기적으로 텍스트 문자열 또는 스트림에 씁니다. (TextWriter에서 상속됨)
Public 메서드WriteAsync(String)스트림에 비동기적으로 문자열을 씁니다. (TextWriter.WriteAsync(String)을(를) 재정의함)
Public 메서드WriteAsync(Char[], Int32, Int32)스트림에 비동기적으로 문자의 하위 배열을 씁니다. (TextWriter.WriteAsync(Char[], Int32, Int32)을(를) 재정의함)
Public 메서드WriteLine()텍스트 스트림에 줄 종결자를 씁니다. (TextWriter에서 상속됨)
Public 메서드WriteLine(Boolean)Boolean의 텍스트 표현과 줄 종결자를 차례로 텍스트 스트림에 씁니다. (TextWriter에서 상속됨)
Public 메서드WriteLine(Char)문자와 줄 종결자를 차례로 텍스트 스트림에 씁니다. (TextWriter에서 상속됨)
Public 메서드WriteLine(Char[])문자 배열과 줄 종결자를 차례로 텍스트 스트림에 씁니다. (TextWriter에서 상속됨)
Public 메서드WriteLine(Decimal)10진수 값의 텍스트 표현과 줄 종결자를 차례로 텍스트 스트림에 씁니다. (TextWriter에서 상속됨)
Public 메서드WriteLine(Double)8바이트 부동 소수점 값의 텍스트 표현과 줄 종결자를 차례로 텍스트 스트림에 씁니다. (TextWriter에서 상속됨)
Public 메서드WriteLine(Int32)부호 있는 4바이트 정수의 텍스트 표현과 줄 종결자를 차례로 텍스트 스트림에 씁니다. (TextWriter에서 상속됨)
Public 메서드WriteLine(Int64)부호 있는 8바이트 정수의 텍스트 표현과 줄 종결자를 차례로 텍스트 스트림에 씁니다. (TextWriter에서 상속됨)
Public 메서드WriteLine(Object)이 개체에 대해 ToString을 호출하여 만들어진 개체의 텍스트 표현과 줄 종결자를 차례로 텍스트 스트림에 씁니다. (TextWriter에서 상속됨)
Public 메서드WriteLine(Single)4바이트 부동 소수점 값의 텍스트 표현과 줄 종결자를 차례로 텍스트 스트림에 씁니다. (TextWriter에서 상속됨)
Public 메서드WriteLine(String)문자열과 줄 종결자를 차례로 텍스트 스트림에 씁니다. (TextWriter에서 상속됨)
Public 메서드WriteLine(UInt32)부호 없는 4바이트 정수의 텍스트 표현과 줄 종결자를 차례로 텍스트 스트림에 씁니다. (TextWriter에서 상속됨)
Public 메서드WriteLine(UInt64)부호 없는 8바이트 정수의 텍스트 표현과 줄 종결자를 차례로 텍스트 스트림에 씁니다. (TextWriter에서 상속됨)
Public 메서드WriteLine(String, Object)Format과 같은 의미를 사용하여 서식이 지정된 문자열과 새 줄을 출력합니다. (TextWriter에서 상속됨)
Public 메서드WriteLine(String, Object[])Format과 같은 의미를 사용하여 서식이 지정된 문자열과 새 줄을 출력합니다. (TextWriter에서 상속됨)
Public 메서드WriteLine(Char[], Int32, Int32)문자의 하위 배열과 줄 종결자를 차례로 텍스트 스트림에 씁니다. (TextWriter에서 상속됨)
Public 메서드WriteLine(String, Object, Object)Format과 같은 의미를 사용하여 서식이 지정된 문자열과 새 줄을 출력합니다. (TextWriter에서 상속됨)
Public 메서드WriteLineAsync()줄 종결자를 비동기적으로 스트림에 씁니다. (TextWriter.WriteLineAsync()을(를) 재정의함)
Public 메서드WriteLineAsync(Char)문자와 줄 종결자를 비동기적으로 스트림에 씁니다. (TextWriter.WriteLineAsync(Char)을(를) 재정의함)
Public 메서드WriteLineAsync(Char[])문자 배열과 줄 종결자를 비동기적으로 텍스트 문자열 또는 스트림에 씁니다. (TextWriter에서 상속됨)
Public 메서드WriteLineAsync(String)문자열과 줄 종결자를 비동기적으로 스트림에 씁니다. (TextWriter.WriteLineAsync(String)을(를) 재정의함)
Public 메서드WriteLineAsync(Char[], Int32, Int32)문자의 하위 배열과 줄 종결자를 비동기적으로 스트림에 씁니다. (TextWriter.WriteLineAsync(Char[], Int32, Int32)을(를) 재정의함)
맨 위

  이름설명
Protected 필드CoreNewLineTextWriter에 사용한 새 줄 문자를 저장합니다. (TextWriter에서 상속됨)
Public 필드정적 멤버NullStreamWriter에 쓸 수는 있지만 읽을 수는 없는 백업 저장소를 제공하지 않습니다.
맨 위

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

다르게 지정되지 않은 경우 StreamWriter는 기본적으로 UTF8Encoding의 인스턴스를 사용합니다. 이 UTF8Encoding 인스턴스는 BOM(바이트 순서 표시)을 사용하지 않고 생성되어 해당 GetPreamble 메서드가 비어 있는 바이트 배열을 반환하도록 합니다. UTF-8 인코딩 및 BOM을 사용하여 StreamWriter를 만들려면 StreamWriter(String, Boolean, Encoding) 같이 인코딩을 지정하는 생성자를 사용합니다.

기본적으로 StreamWriter는 스레드로부터 안전하지 않습니다.

다음 예제에서는 StreamWriter를 사용하여 사용자의 내 문서 폴더에 있는 파일에 텍스트 상자 컨트롤(즉 inputData)의 내용을 저장합니다. 파일 콘텐츠를 읽는 방법을 보여 주는 예제는 StreamReader 클래스를 참조하세요.


private void SaveFile_Click(object sender, RoutedEventArgs e)
{
	// fileLoc is a global string variable, set in StreamReader example.
	using (StreamWriter sw = new StreamWriter(fileLoc, false))
	{
		sw.WriteLine(inputData.Text);
		inputData.Text = "";
		inputData.Visibility = Visibility.Collapsed;
	}
	
}


Windows Phone OS

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

Windows Phone

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

표시: