TextWriter 클래스

  • 참조

정의

네임스페이스:
System.IO
어셈블리:
System.IO.dll
어셈블리:
System.Runtime.dll
어셈블리:
System.Runtime.Extensions.dll
어셈블리:
mscorlib.dll
어셈블리:
netstandard.dll
Source:
TextWriter.cs
Source:
TextWriter.cs
Source:
TextWriter.cs

일련의 문자를 연속하여 쓸 수 있는 작성기를 나타냅니다. 이 클래스는 추상 클래스입니다.

public ref class TextWriter abstract : IDisposable
public ref class TextWriter abstract : MarshalByRefObject, IAsyncDisposable, IDisposable
public ref class TextWriter abstract : MarshalByRefObject, IDisposable
public abstract class TextWriter : IDisposable
public abstract class TextWriter : MarshalByRefObject, IAsyncDisposable, IDisposable
public abstract class TextWriter : MarshalByRefObject, IDisposable
[System.Serializable]
public abstract class TextWriter : MarshalByRefObject, IDisposable
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class TextWriter : MarshalByRefObject, IDisposable
type TextWriter = class
    interface IDisposable
type TextWriter = class
    inherit MarshalByRefObject
    interface IAsyncDisposable
    interface IDisposable
type TextWriter = class
    inherit MarshalByRefObject
    interface IDisposable
[<System.Serializable>]
type TextWriter = class
    inherit MarshalByRefObject
    interface IDisposable
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type TextWriter = class
    inherit MarshalByRefObject
    interface IDisposable
Public MustInherit Class TextWriter
Implements IDisposable
Public MustInherit Class TextWriter
Inherits MarshalByRefObject
Implements IAsyncDisposable, IDisposable
Public MustInherit Class TextWriter
Inherits MarshalByRefObject
Implements IDisposable
상속
Object
TextWriter
상속
Object
MarshalByRefObject
TextWriter
파생
특성
SerializableAttribute ComVisibleAttribute
구현
IDisposable IAsyncDisposable

예제

TextWriter 클래스는 추상 클래스입니다. 따라서 코드에서 인스턴스화하지 않습니다. 클래스에서 StreamWriterTextWriter 파생 하 고 스트림에 쓰기 위한 멤버의 구현을 제공 합니다. 다음 예제에서는 메서드를 사용하여 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는 각각 스트림과 문자열에 문자를 쓰는 및 StringWriter의 StreamWriter 추상 기본 클래스입니다. 의 instance TextWriter 사용하여 문자열에 개체를 쓰거나, 파일에 문자열을 쓰거나, XML을 serialize합니다. 의 instance TextWriter 사용하여 문자열 또는 스트림에 사용하는 것과 동일한 API를 사용하여 사용자 지정 지원 저장소에 텍스트를 쓰거나 텍스트 서식 지정에 대한 지원을 추가할 수도 있습니다.

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

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

중요

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

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

구현자 참고

파생 클래스는 의 유용한 instance TextWriter만들기 위해 메서드를 최소한으로 구현 Write(Char) 해야 합니다.

생성자

TextWriter()

TextWriter 클래스의 새 인스턴스를 초기화합니다.
TextWriter(IFormatProvider)

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

필드

CoreNewLine

이 TextWriter에 사용한 줄 바꿈 문자를 저장합니다.
Null

쓸 수는 있지만 읽을 수는 없는 백업 저장소를 TextWriter에 제공하지 않습니다.

속성

Encoding

파생 클래스에서 재정의된 경우 출력을 쓰는 문자 인코딩을 반환합니다.
FormatProvider

서식 지정을 제어하는 개체를 가져옵니다.
NewLine

현재 TextWriter에서 사용한 줄 종결자 문자열을 가져오거나 설정합니다.

메서드

Close()

현재 작성기를 닫고 그 작성기와 관련된 모든 시스템 리소스를 해제합니다.
CreateBroadcasting(TextWriter[])

일련의 문자를 연속하여 쓸 수 있는 작성기를 나타냅니다. 이 클래스는 추상 클래스입니다.
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)

문자열 빌더의 텍스트 표현과 줄 종결자를 차례로 텍스트 스트림에 비동기식으로 씁니다.

명시적 인터페이스 구현

IDisposable.Dispose()

이 멤버에 대한 설명은 Dispose()를 참조하세요.

확장 메서드

ConfigureAwait(IAsyncDisposable, Boolean)

비동기 일회용에서 반환되는 작업을 대기하는 방법을 구성합니다.

적용 대상

추가 정보