TextWriter 클래스

정의

네임스페이스:

System.IO

어셈블리:

System.Runtime.dll

Source:

TextWriter.cs

일련의 문자를 순차적으로 작성할 수 있는 작성기를 나타냅니다. 이 클래스는 추상입니다.

public ref class TextWriter abstract : MarshalByRefObject, IAsyncDisposable, IDisposable

public abstract class TextWriter : MarshalByRefObject, IAsyncDisposable, IDisposable

type TextWriter = class
    inherit MarshalByRefObject
    interface IAsyncDisposable
    interface IDisposable

Public MustInherit Class TextWriter
Inherits MarshalByRefObject
Implements IAsyncDisposable, IDisposable

상속

Object

MarshalByRefObject

TextWriter

파생

System.CodeDom.Compiler.IndentedTextWriter

System.IO.StreamWriter

System.IO.StringWriter

System.Web.HttpWriter

System.Web.UI.HtmlTextWriter

구현

IDisposable IAsyncDisposable

예제

TextWriter 클래스는 추상 클래스입니다. 따라서 코드에서 인스턴스화하지 않습니다. StreamWriter 클래스는 TextWriter 파생되며 스트림에 쓰기 위한 멤버의 구현을 제공합니다. 다음 예제에서는 WriteLineAsync(String) 메서드를 사용하여 문자열 값으로 구성된 두 줄을 텍스트 파일에 쓰는 방법을 보여 있습니다.

using System.IO;

namespace ConsoleApplication
{
    class Program4
    {
        static void Main()
        {
            WriteCharacters();
        }

        static async void WriteCharacters()
        {
            using (StreamWriter writer = File.CreateText("newfile.txt"))
            {
                await writer.WriteLineAsync("First line of example");
                await writer.WriteLineAsync("and second line");
            }
        }
    }
}

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        WriteCharacters()
    End Sub

    Async Sub WriteCharacters()
        Using writer As StreamWriter = File.CreateText("newfile.txt")
            Await writer.WriteLineAsync("First line of example")
            Await writer.WriteLineAsync("and second line")
        End Using
    End Sub
End Module

설명

TextWriter 각각 스트림과 문자열에 문자를 쓰는 StreamWriter 및 StringWriter추상 기본 클래스입니다. TextWriter 인스턴스를 사용하여 문자열에 개체를 쓰거나, 파일에 문자열을 쓰거나, XML을 serialize합니다. TextWriter 인스턴스를 사용하여 문자열 또는 스트림에 사용하는 것과 동일한 API를 사용하여 사용자 지정 백업 저장소에 텍스트를 쓰거나 텍스트 서식 지정에 대한 지원을 추가할 수도 있습니다.

기본 데이터 형식을 매개 변수로 사용하는 TextWriter 모든 Write 메서드는 값을 문자열로 기록합니다.

기본적으로 TextWriter 스레드로부터 안전하지 않습니다. 스레드로부터 안전한 래퍼는 TextWriter.Synchronized 참조하세요.

중요하다

이 형식은 IDisposable 인터페이스를 구현합니다. 이 형식에서 파생된 모든 형식의 사용을 완료한 경우 직접 또는 간접적으로 삭제해야 합니다. 형식을 직접 삭제하려면 try/catch 블록에서 해당 Dispose 메서드를 호출합니다. 간접적으로 삭제하려면 using(C#) 또는 Using(Visual Basic)와 같은 언어 구문을 사용합니다. 자세한 내용은 IDisposable 인터페이스 항목의 Dispose 및 "IDisposable을 구현하는 개체 사용" 섹션을 참조하세요.

일반적인 I/O 작업 목록은 일반적인 I/O 작업참조하세요.

구현자 참고

파생 클래스는 Write(Char) 메서드를 최소로 구현하여 유용한 TextWriter인스턴스를 만들어야 합니다.

생성자

TextWriter()	TextWriter 클래스의 새 인스턴스를 초기화합니다.
TextWriter(IFormatProvider)	지정된 형식 공급자를 사용하여 TextWriter 클래스의 새 인스턴스를 초기화합니다.

필드

CoreNewLine	이 TextWriter사용되는 줄 바꿈 문자를 저장합니다.
Null	기록할 수 있지만 읽을 수 없는 백업 저장소가 없는 TextWriter 제공합니다.

속성

Encoding	파생 클래스에서 재정의되는 경우 출력이 기록되는 문자 인코딩을 반환합니다.
FormatProvider	서식을 제어하는 개체를 가져옵니다.
NewLine	현재 TextWriter사용되는 줄 종결자 문자열을 가져오거나 설정합니다.

메서드

Close()	현재 작성기를 닫고 기록기와 연결된 시스템 리소스를 해제합니다.
CreateObjRef(Type)	원격 개체와 통신하는 데 사용되는 프록시를 생성하는 데 필요한 모든 관련 정보를 포함하는 개체를 만듭니다. (다음에서 상속됨 MarshalByRefObject)
Dispose()	TextWriter 개체에서 사용하는 모든 리소스를 해제합니다.
Dispose(Boolean)	TextWriter 사용하는 관리되지 않는 리소스를 해제하고 필요에 따라 관리되는 리소스를 해제합니다.
DisposeAsync()	TextWriter 개체에서 사용하는 모든 리소스를 비동기적으로 해제합니다.
Equals(Object)	지정된 개체가 현재 개체와 같은지 여부를 확인합니다. (다음에서 상속됨 Object)
Flush()	현재 기록기에 대한 모든 버퍼를 지우고 버퍼링된 데이터가 기본 디바이스에 기록되도록 합니다.
FlushAsync()	현재 기록기에 대한 모든 버퍼를 비동기적으로 지우고 버퍼링된 데이터가 기본 디바이스에 기록되도록 합니다.
FlushAsync(CancellationToken)	현재 기록기에 대한 모든 버퍼를 비동기적으로 지우고 버퍼링된 데이터가 기본 디바이스에 기록되도록 합니다.
GetHashCode()	기본 해시 함수로 사용됩니다. (다음에서 상속됨 Object)
GetLifetimeService()	사용되지 않음. 이 인스턴스의 수명 정책을 제어하는 현재 수명 서비스 개체를 검색합니다. (다음에서 상속됨 MarshalByRefObject)
GetType()	현재 인스턴스의 Type 가져옵니다. (다음에서 상속됨 Object)
InitializeLifetimeService()	사용되지 않음. 이 인스턴스의 수명 정책을 제어하는 수명 서비스 개체를 가져옵니다. (다음에서 상속됨 MarshalByRefObject)
MemberwiseClone()	현재 Object단순 복사본을 만듭니다. (다음에서 상속됨 Object)
MemberwiseClone(Boolean)	현재 MarshalByRefObject 개체의 단순 복사본을 만듭니다. (다음에서 상속됨 MarshalByRefObject)
Synchronized(TextWriter)	지정된 TextWriter주위에 스레드로부터 안전한 래퍼를 만듭니다.
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)
Write(Boolean)	Boolean 값의 텍스트 표현을 텍스트 스트림에 씁니다.
Write(Char)	텍스트 스트림에 문자를 씁니다.
Write(Char[])	텍스트 스트림에 문자 배열을 씁니다.
Write(Char[], Int32, Int32)	문자의 하위 배열을 텍스트 스트림에 씁니다.
Write(Decimal)	10진수 값의 텍스트 표현을 텍스트 스트림에 씁니다.
Write(Double)	8 바이트 부동 소수점 값의 텍스트 표현을 텍스트 스트림에 씁니다.
Write(Int32)	텍스트 스트림에 부가된 4 바이트 정수의 텍스트 표현을 씁니다.
Write(Int64)	텍스트 스트림에 부가된 8 바이트 정수의 텍스트 표현을 씁니다.
Write(Object)	해당 개체에서 ToString 메서드를 호출하여 텍스트 스트림에 개체의 텍스트 표현을 씁니다.
Write(ReadOnlySpan<Char>)	텍스트 스트림에 문자 범위를 씁니다.
Write(Single)	4 바이트 부동 소수점 값의 텍스트 표현을 텍스트 스트림에 씁니다.
Write(String)	텍스트 스트림에 문자열을 씁니다.
Write(String, Object)	Format(String, Object) 메서드와 동일한 의미 체계를 사용하여 서식이 지정된 문자열을 텍스트 스트림에 씁니다.
Write(String, Object, Object)	Format(String, Object, Object) 메서드와 동일한 의미 체계를 사용하여 서식이 지정된 문자열을 텍스트 스트림에 씁니다.
Write(String, Object, Object, Object)	Format(String, Object, Object, Object) 메서드와 동일한 의미 체계를 사용하여 서식이 지정된 문자열을 텍스트 스트림에 씁니다.
Write(String, Object[])	Format(String, Object[]) 메서드와 동일한 의미 체계를 사용하여 서식이 지정된 문자열을 텍스트 스트림에 씁니다.
Write(StringBuilder)	문자열 작성기를 텍스트 스트림에 씁니다.
Write(UInt32)	4 바이트 부호 없는 정수의 텍스트 표현을 텍스트 스트림에 씁니다.
Write(UInt64)	8 바이트 부호 없는 정수의 텍스트 표현을 텍스트 스트림에 씁니다.
WriteAsync(Char)	문자를 텍스트 스트림에 비동기적으로 씁니다.
WriteAsync(Char[])	문자 배열을 텍스트 스트림에 비동기적으로 씁니다.
WriteAsync(Char[], Int32, Int32)	문자의 하위 배열을 텍스트 스트림에 비동기적으로 씁니다.
WriteAsync(ReadOnlyMemory<Char>, CancellationToken)	문자 메모리 영역을 텍스트 스트림에 비동기적으로 씁니다.
WriteAsync(String)	문자열을 텍스트 스트림에 비동기적으로 씁니다.
WriteAsync(StringBuilder, CancellationToken)	문자열 작성기를 텍스트 스트림에 비동기적으로 씁니다.
WriteLine()	텍스트 스트림에 줄 종결자를 씁니다.
WriteLine(Boolean)	Boolean 값의 텍스트 표현을 텍스트 스트림에 쓴 다음 줄 종결자를 씁니다.
WriteLine(Char)	텍스트 스트림에 문자를 쓴 다음 줄 종결자를 씁니다.
WriteLine(Char[])	문자 배열을 텍스트 스트림에 쓴 다음 줄 종결자를 씁니다.
WriteLine(Char[], Int32, Int32)	문자의 하위 배열을 텍스트 스트림에 쓴 다음 줄 종결자를 씁니다.
WriteLine(Decimal)	10진수 값의 텍스트 표현을 텍스트 스트림에 쓴 다음 줄 종결자를 씁니다.
WriteLine(Double)	8 바이트 부동 소수점 값의 텍스트 표현을 텍스트 스트림에 쓴 다음 줄 종결자를 씁니다.
WriteLine(Int32)	텍스트 스트림에 부호 있는 4 바이트 정수의 텍스트 표현과 줄 종결자를 씁니다.
WriteLine(Int64)	텍스트 스트림에 부호 있는 8 바이트 정수의 텍스트 표현과 줄 종결자를 씁니다.
WriteLine(Object)	해당 개체에서 ToString 메서드를 호출한 다음 줄 종결자를 호출하여 개체의 텍스트 표현을 텍스트 스트림에 씁니다.
WriteLine(ReadOnlySpan<Char>)	문자 범위의 텍스트 표현을 텍스트 스트림에 쓴 다음 줄 종결자를 씁니다.
WriteLine(Single)	4 바이트 부동 소수점 값의 텍스트 표현을 텍스트 스트림에 쓴 다음 줄 종결자를 씁니다.
WriteLine(String)	문자열을 텍스트 스트림에 쓴 다음 줄 종결자를 씁니다.
WriteLine(String, Object)	Format(String, Object) 메서드와 동일한 의미 체계를 사용하여 서식이 지정된 문자열과 새 줄을 텍스트 스트림에 씁니다.
WriteLine(String, Object, Object)	Format(String, Object, Object) 메서드와 동일한 의미 체계를 사용하여 서식이 지정된 문자열과 새 줄을 텍스트 스트림에 씁니다.
WriteLine(String, Object, Object, Object)	Format(String, Object)동일한 의미 체계를 사용하여 서식이 지정된 문자열과 새 줄을 텍스트 스트림에 씁니다.
WriteLine(String, Object[])	Format(String, Object)동일한 의미 체계를 사용하여 서식이 지정된 문자열과 새 줄을 텍스트 스트림에 씁니다.
WriteLine(StringBuilder)	문자열 작성기의 텍스트 표현을 텍스트 스트림에 쓴 다음 줄 종결자를 씁니다.
WriteLine(UInt32)	4 바이트 부호 없는 정수의 텍스트 표현을 텍스트 스트림에 쓴 다음 줄 종결자를 씁니다.
WriteLine(UInt64)	8 바이트 부호 없는 정수의 텍스트 표현을 텍스트 스트림에 쓴 다음 줄 종결자를 씁니다.
WriteLineAsync()	텍스트 스트림에 줄 종결자를 비동기적으로 씁니다.
WriteLineAsync(Char)	텍스트 스트림에 문자를 비동기적으로 쓴 다음 줄 종결자를 씁니다.
WriteLineAsync(Char[])	문자 배열을 텍스트 스트림에 비동기적으로 쓴 다음 줄 종결자를 씁니다.
WriteLineAsync(Char[], Int32, Int32)	문자의 하위 배열을 텍스트 스트림에 비동기적으로 쓴 다음 줄 종결자를 씁니다.
WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)	문자 메모리 영역의 텍스트 표현을 텍스트 스트림에 비동기적으로 쓴 다음 줄 종결자를 씁니다.
WriteLineAsync(String)	문자열을 텍스트 스트림에 비동기적으로 쓴 다음 줄 종결자를 씁니다.
WriteLineAsync(StringBuilder, CancellationToken)	문자열 작성기의 텍스트 표현을 텍스트 스트림에 비동기적으로 쓴 다음 줄 종결자를 씁니다.

확장 메서드

ConfigureAwait(IAsyncDisposable, Boolean)

비동기 삭제 가능 파일에서 반환된 작업에 대한 대기가 수행되는 방법을 구성합니다.

추가 정보

• StreamWriter
• StringWriter
• 파일 및 스트림 I/O
• 방법: 파일 텍스트 읽기
• 방법: 파일 텍스트 쓰기
• 방법: 새로 만든 데이터 파일 읽기 및 쓰기