TextWriter TextWriter TextWriter TextWriter Class

정의

일련의 문자를 연속하여 쓸 수 있는 작성기를 나타냅니다.Represents a writer that can write a sequential series of characters. 이 클래스는 추상 클래스입니다.This class is abstract.

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

예제

TextWriter 클래스는 추상 클래스입니다.The TextWriter class is an abstract class. 따라서 인스턴스화하지 않습니다 해당 코드에서.Therefore, you do not instantiate it in your code. StreamWriter 클래스에서 파생 되며 TextWriter 스트림에 쓸에 대 한 멤버의 구현을 제공 합니다.The StreamWriter class derives from TextWriter and provides implementations of the members for writing to a stream. 다음 예제에서는 문자열 값을 텍스트 파일을 사용 하 여 구성 된 두 줄을 작성 하는 방법을 보여 줍니다는 WriteLineAsync(String) 메서드.The following example shows how to write two lines that consist of string values to a text file by using the WriteLineAsync(String) method.

제공 하는 파생된 클래스에서 Dispose를 재정의 합니다.Override Dispose in a derived class to provide

using System;
using System.IO;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            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 추상 기본 클래스인 StreamWriterStringWriter를 작성 하는 문자 스트림 및 문자열, 각각.TextWriter is the abstract base class of StreamWriter and StringWriter, which write characters to streams and strings, respectively. 인스턴스를 만들고 TextWriter 문자열 개체에 쓰기, 파일, 문자열에 쓸 또는 XML을 serialize 합니다.Create an instance of TextWriter to write an object to a string, write strings to a file, or to serialize XML. 인스턴스를 사용할 수도 있습니다 TextWriter 텍스트 문자열 또는 스트림에 사용 같은 Api를 사용 하 여 사용자 지정 백업 저장소에 쓸 또는 텍스트 서식 지정에 대 한 지원을 추가 합니다.You can also use an instance of TextWriter to write text to a custom backing store using the same APIs you would use for a string or a stream, or to add support for text formatting.

모든 합니다 Write 메서드의 TextWriter 매개 변수 값을 문자열로 작성으로 기본 데이터 형식이 있습니다.All the Write methods of TextWriter having primitive data types as parameters write out the values as strings.

기본적으로 TextWriter 은 스레드로부터 안전 합니다.By default, a TextWriter is not thread safe. 참조 TextWriter.Synchronized 스레드로부터 안전한 래퍼에 대 한 합니다.See TextWriter.Synchronized for a thread-safe wrapper.

중요

이 형식이 구현 하는 IDisposable 인터페이스입니다.This type implements the IDisposable interface. 이 형식에서 파생 되는 모든 형식을 사용 하 여 마쳤으면 직접 또는 간접적으로으로 삭제 해야 있습니다.When you have finished using any type that derives from this type, you should dispose of it either directly or indirectly. 직접 형식의 dispose 호출 해당 Dispose 의 메서드를 try / catch 블록입니다.To dispose of the type directly, call its Dispose method in a try/catch block. 삭제 하지 직접, 언어 구문 같은 사용 using (C#에서) 또는 Using (Visual Basic에서는).To dispose of it indirectly, use a language construct such as using (in C#) or Using (in Visual Basic). 자세한 내용은 Dispose 및 "를 사용 하는 개체는 구현 IDisposable" 섹션을 참조 하십시오.는 IDisposable 인터페이스 항목입니다.For more information, see Dispose and the "Using an Object that Implements IDisposable" section in the IDisposable interface topic.

공통적인 I/O 작업의 목록을 참조 하세요 공통적인 I/O 작업합니다.For a list of common I/O tasks, see Common I/O Tasks.

상속자 참고

파생된 클래스가 최소한으로 구현 해야 합니다 Write(Char) 의 유용한 인스턴스를 만들 방법 TextWriter합니다.A derived class must minimally implement the Write(Char) method to make a useful instance of TextWriter.

생성자

TextWriter() TextWriter() TextWriter() TextWriter()

TextWriter 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the TextWriter class.

TextWriter(IFormatProvider) TextWriter(IFormatProvider) TextWriter(IFormatProvider) TextWriter(IFormatProvider)

지정된 서식 공급자를 사용하여 TextWriter 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the TextWriter class with the specified format provider.

필드

CoreNewLine CoreNewLine CoreNewLine CoreNewLine

TextWriter에 사용한 줄 바꿈 문자를 저장합니다.Stores the newline characters used for this TextWriter.

Null Null Null Null

쓸 수는 있지만 읽을 수는 없는 백업 저장소를 TextWriter에 제공하지 않습니다.Provides a TextWriter with no backing store that can be written to, but not read from.

속성

Encoding Encoding Encoding Encoding

파생 클래스에서 재정의된 경우 출력을 쓰는 문자 인코딩을 반환합니다.When overridden in a derived class, returns the character encoding in which the output is written.

FormatProvider FormatProvider FormatProvider FormatProvider

서식 지정을 제어하는 개체를 가져옵니다.Gets an object that controls formatting.

NewLine NewLine NewLine NewLine

현재 TextWriter에서 사용한 줄 종결자 문자열을 가져오거나 설정합니다.Gets or sets the line terminator string used by the current TextWriter.

메서드

Close() Close() Close() Close()

현재 작성기를 닫고 그 작성기와 관련된 모든 시스템 리소스를 해제합니다.Closes the current writer and releases any system resources associated with the writer.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

원격 개체와 통신하는 데 사용되는 프록시 생성에 필요한 모든 관련 정보가 들어 있는 개체를 만듭니다.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

해당 TextWriter 개체에서 사용하는 리소스를 모두 해제합니다.Releases all resources used by the TextWriter object.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

TextWriter에서 사용하는 관리되지 않는 리소스를 해제하고, 관리되는 리소스를 선택적으로 해제할 수 있습니다.Releases the unmanaged resources used by the TextWriter and optionally releases the managed resources.

DisposeAsync() DisposeAsync() DisposeAsync() DisposeAsync()
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Flush() Flush() Flush() Flush()

현재 작성기에 대한 모든 버퍼를 지우면 버퍼링된 모든 데이터를 내부 장치에 씁니다.Clears all buffers for the current writer and causes any buffered data to be written to the underlying device.

FlushAsync() FlushAsync() FlushAsync() FlushAsync()

현재 작성기에 대한 모든 버퍼를 비동기적으로 지우면 버퍼링된 모든 데이터를 내부 장치에 씁니다.Asynchronously clears all buffers for the current writer and causes any buffered data to be written to the underlying device.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

이 인스턴스의 수명 정책을 제어하는 현재의 수명 서비스 개체를 검색합니다.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetType() GetType() GetType() GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

이 인스턴스의 수명 정책을 제어하는 수명 서비스 개체를 가져옵니다.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

현재 MarshalByRefObject 개체의 단순 복사본을 만듭니다.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
Synchronized(TextWriter) Synchronized(TextWriter) Synchronized(TextWriter) Synchronized(TextWriter)

지정된 TextWriter 주위에 스레드로부터 안전한 래퍼를 만듭니다.Creates a thread-safe wrapper around the specified TextWriter.

ToString() ToString() ToString() ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(Inherited from Object)
Write(Boolean) Write(Boolean) Write(Boolean) Write(Boolean)

Boolean 값의 텍스트 표현을 텍스트 문자열 또는 스트림에 씁니다.Writes the text representation of a Boolean value to the text string or stream.

Write(Char) Write(Char) Write(Char) Write(Char)

문자를 텍스트 문자열 또는 스트림에 씁니다.Writes a character to the text string or stream.

Write(Char[]) Write(Char[]) Write(Char[]) Write(Char[])

문자 배열을 텍스트 문자열 또는 스트림에 씁니다.Writes a character array to the text string or stream.

Write(Char[], Int32, Int32) Write(Char[], Int32, Int32) Write(Char[], Int32, Int32) Write(Char[], Int32, Int32)

문자의 하위 배열을 텍스트 문자열 또는 스트림에 씁니다.Writes a subarray of characters to the text string or stream.

Write(Decimal) Write(Decimal) Write(Decimal) Write(Decimal)

10진수 값의 텍스트 표현을 텍스트 문자열 또는 스트림에 씁니다.Writes the text representation of a decimal value to the text string or stream.

Write(Double) Write(Double) Write(Double) Write(Double)

8바이트 부동 소수점 값의 텍스트 표현을 텍스트 문자열 또는 스트림에 씁니다.Writes the text representation of an 8-byte floating-point value to the text string or stream.

Write(Int32) Write(Int32) Write(Int32) Write(Int32)

부호 있는 4바이트 정수의 텍스트 표현을 텍스트 문자열 또는 스트림에 씁니다.Writes the text representation of a 4-byte signed integer to the text string or stream.

Write(Int64) Write(Int64) Write(Int64) Write(Int64)

부호 있는 8바이트 정수의 텍스트 표현을 텍스트 문자열 또는 스트림에 씁니다.Writes the text representation of an 8-byte signed integer to the text string or stream.

Write(Object) Write(Object) Write(Object) Write(Object)

개체에 대해 ToString 메서드를 호출하여 해당 개체의 텍스트 표현을 텍스트 문자열 또는 스트림에 씁니다.Writes the text representation of an object to the text string or stream by calling the ToString method on that object.

Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>)
Write(Single) Write(Single) Write(Single) Write(Single)

4바이트 부동 소수점 값의 텍스트 표현을 텍스트 문자열 또는 스트림에 씁니다.Writes the text representation of a 4-byte floating-point value to the text string or stream.

Write(String) Write(String) Write(String) Write(String)

문자열을 텍스트 문자열 또는 스트림에 씁니다.Writes a string to the text string or stream.

Write(String, Object) Write(String, Object) Write(String, Object) Write(String, Object)

Format(String, Object) 메서드와 동일한 의미 체계를 사용하여 서식이 지정된 문자열을 텍스트 문자열이나 스트림에 씁니다.Writes a formatted string to the text string or stream, using the same semantics as the Format(String, Object) method.

Write(String, Object, Object) Write(String, Object, Object) Write(String, Object, Object) Write(String, Object, Object)

Format(String, Object, Object) 메서드와 동일한 의미 체계를 사용하여 서식이 지정된 문자열을 텍스트 문자열이나 스트림에 씁니다.Writes a formatted string to the text string or stream, using the same semantics as the Format(String, Object, Object) method.

Write(String, Object, Object, Object) Write(String, Object, Object, Object) Write(String, Object, Object, Object) Write(String, Object, Object, Object)

Format(String, Object, Object, Object) 메서드와 동일한 의미 체계를 사용하여 서식이 지정된 문자열을 텍스트 문자열이나 스트림에 씁니다.Writes a formatted string to the text string or stream, using the same semantics as the Format(String, Object, Object, Object) method.

Write(String, Object[]) Write(String, Object[]) Write(String, Object[]) Write(String, Object[])

Format(String, Object[]) 메서드와 동일한 의미 체계를 사용하여 서식이 지정된 문자열을 텍스트 문자열이나 스트림에 씁니다.Writes a formatted string to the text string or stream, using the same semantics as the Format(String, Object[]) method.

Write(StringBuilder) Write(StringBuilder) Write(StringBuilder) Write(StringBuilder)
Write(UInt32) Write(UInt32) Write(UInt32) Write(UInt32)

부호 없는 4바이트 정수의 텍스트 표현을 텍스트 문자열 또는 스트림에 씁니다.Writes the text representation of a 4-byte unsigned integer to the text string or stream.

Write(UInt64) Write(UInt64) Write(UInt64) Write(UInt64)

부호 없는 8바이트 정수의 텍스트 표현을 텍스트 문자열 또는 스트림에 씁니다.Writes the text representation of an 8-byte unsigned integer to the text string or stream.

WriteAsync(Char) WriteAsync(Char) WriteAsync(Char) WriteAsync(Char)

문자를 텍스트 문자열 또는 스트림에 비동기적으로 씁니다.Writes a character to the text string or stream asynchronously.

WriteAsync(Char[]) WriteAsync(Char[]) WriteAsync(Char[]) WriteAsync(Char[])

문자 배열을 텍스트 문자열 또는 스트림에 비동기적으로 씁니다.Writes a character array to the text string or stream asynchronously.

WriteAsync(Char[], Int32, Int32) WriteAsync(Char[], Int32, Int32) WriteAsync(Char[], Int32, Int32) WriteAsync(Char[], Int32, Int32)

문자의 하위 배열을 텍스트 문자열 또는 스트림에 비동기적으로 씁니다.Writes a subarray of characters to the text string or stream asynchronously.

WriteAsync(ReadOnlyMemory<Char>, CancellationToken) WriteAsync(ReadOnlyMemory<Char>, CancellationToken) WriteAsync(ReadOnlyMemory<Char>, CancellationToken) WriteAsync(ReadOnlyMemory<Char>, CancellationToken)
WriteAsync(String) WriteAsync(String) WriteAsync(String) WriteAsync(String)

문자열을 텍스트 문자열 또는 스트림에 비동기적으로 씁니다.Writes a string to the text string or stream asynchronously.

WriteAsync(StringBuilder, CancellationToken) WriteAsync(StringBuilder, CancellationToken) WriteAsync(StringBuilder, CancellationToken) WriteAsync(StringBuilder, CancellationToken)
WriteLine() WriteLine() WriteLine() WriteLine()

줄 종결자를 텍스트 문자열 또는 스트림에 씁니다.Writes a line terminator to the text string or stream.

WriteLine(Boolean) WriteLine(Boolean) WriteLine(Boolean) WriteLine(Boolean)

Boolean 값의 텍스트 표현과 줄 종결자를 차례로 텍스트 문자열 또는 스트림에 씁니다.Writes the text representation of a Boolean value followed by a line terminator to the text string or stream.

WriteLine(Char) WriteLine(Char) WriteLine(Char) WriteLine(Char)

문자와 줄 종결자를 차례로 텍스트 문자열 또는 스트림에 씁니다.Writes a character followed by a line terminator to the text string or stream.

WriteLine(Char[]) WriteLine(Char[]) WriteLine(Char[]) WriteLine(Char[])

문자의 배열과 줄 종결자를 차례로 텍스트 문자열 또는 스트림에 씁니다.Writes an array of characters followed by a line terminator to the text string or stream.

WriteLine(Char[], Int32, Int32) WriteLine(Char[], Int32, Int32) WriteLine(Char[], Int32, Int32) WriteLine(Char[], Int32, Int32)

문자의 하위 배열과 줄 종결자를 차례로 텍스트 문자열 또는 스트림에 씁니다.Writes a subarray of characters followed by a line terminator to the text string or stream.

WriteLine(Decimal) WriteLine(Decimal) WriteLine(Decimal) WriteLine(Decimal)

10진수 값의 텍스트 표현과 줄 종결자를 차례로 텍스트 문자열 또는 스트림에 씁니다.Writes the text representation of a decimal value followed by a line terminator to the text string or stream.

WriteLine(Double) WriteLine(Double) WriteLine(Double) WriteLine(Double)

8바이트 부동 소수점 값의 텍스트 표현과 줄 종결자를 차례로 텍스트 문자열 또는 스트림에 씁니다.Writes the text representation of a 8-byte floating-point value followed by a line terminator to the text string or stream.

WriteLine(Int32) WriteLine(Int32) WriteLine(Int32) WriteLine(Int32)

부호 있는 4바이트 정수의 텍스트 표현과 줄 종결자를 차례로 텍스트 문자열 또는 스트림에 씁니다.Writes the text representation of a 4-byte signed integer followed by a line terminator to the text string or stream.

WriteLine(Int64) WriteLine(Int64) WriteLine(Int64) WriteLine(Int64)

부호 있는 8바이트 정수의 텍스트 표현과 줄 종결자를 차례로 텍스트 문자열 또는 스트림에 씁니다.Writes the text representation of an 8-byte signed integer followed by a line terminator to the text string or stream.

WriteLine(Object) WriteLine(Object) WriteLine(Object) WriteLine(Object)

개체에 대해 ToString 메서드를 호출하여 해당 개체의 텍스트 표현과 줄 종결자를 차례로 텍스트 문자열 또는 스트림에 씁니다.Writes the text representation of an object by calling the ToString method on that object, followed by a line terminator to the text string or stream.

WriteLine(ReadOnlySpan<Char>) WriteLine(ReadOnlySpan<Char>) WriteLine(ReadOnlySpan<Char>) WriteLine(ReadOnlySpan<Char>)
WriteLine(Single) WriteLine(Single) WriteLine(Single) WriteLine(Single)

4바이트 부동 소수점 값의 텍스트 표현과 줄 종결자를 차례로 텍스트 문자열 또는 스트림에 씁니다.Writes the text representation of a 4-byte floating-point value followed by a line terminator to the text string or stream.

WriteLine(String) WriteLine(String) WriteLine(String) WriteLine(String)

문자열과 줄 종결자를 차례로 텍스트 문자열 또는 스트림에 씁니다.Writes a string followed by a line terminator to the text string or stream.

WriteLine(String, Object) WriteLine(String, Object) WriteLine(String, Object) WriteLine(String, Object)

Format(String, Object) 메서드와 동일한 의미 체계를 사용하여 서식이 지정된 문자열과 새 줄을 텍스트 문자열이나 스트림에 씁니다.Writes a formatted string and a new line to the text string or stream, using the same semantics as the Format(String, Object) method.

WriteLine(String, Object, Object) WriteLine(String, Object, Object) WriteLine(String, Object, Object) WriteLine(String, Object, Object)

Format(String, Object, Object) 메서드와 동일한 의미 체계를 사용하여 서식이 지정된 문자열과 새 줄을 텍스트 문자열이나 스트림에 씁니다.Writes a formatted string and a new line to the text string or stream, using the same semantics as the Format(String, Object, Object) method.

WriteLine(String, Object, Object, Object) WriteLine(String, Object, Object, Object) WriteLine(String, Object, Object, Object) WriteLine(String, Object, Object, Object)

Format(String, Object)과 같은 의미 체계를 사용하여 서식이 지정된 문자열과 새 줄을 씁니다.Writes out a formatted string and a new line, using the same semantics as Format(String, Object).

WriteLine(String, Object[]) WriteLine(String, Object[]) WriteLine(String, Object[]) WriteLine(String, Object[])

Format(String, Object)과 같은 의미 체계를 사용하여 서식이 지정된 문자열과 새 줄을 씁니다.Writes out a formatted string and a new line, using the same semantics as Format(String, Object).

WriteLine(StringBuilder) WriteLine(StringBuilder) WriteLine(StringBuilder) WriteLine(StringBuilder)
WriteLine(UInt32) WriteLine(UInt32) WriteLine(UInt32) WriteLine(UInt32)

부호 없는 4바이트 정수의 텍스트 표현과 줄 종결자를 차례로 텍스트 문자열 또는 스트림에 씁니다.Writes the text representation of a 4-byte unsigned integer followed by a line terminator to the text string or stream.

WriteLine(UInt64) WriteLine(UInt64) WriteLine(UInt64) WriteLine(UInt64)

부호 없는 8바이트 정수의 텍스트 표현과 줄 종결자를 차례로 텍스트 문자열 또는 스트림에 씁니다.Writes the text representation of an 8-byte unsigned integer followed by a line terminator to the text string or stream.

WriteLineAsync() WriteLineAsync() WriteLineAsync() WriteLineAsync()

줄 종결자를 텍스트 문자열 또는 스트림에 비동기적으로 씁니다.Writes a line terminator asynchronously to the text string or stream.

WriteLineAsync(Char) WriteLineAsync(Char) WriteLineAsync(Char) WriteLineAsync(Char)

문자와 줄 종결자를 차례로 텍스트 문자열 또는 스트림에 비동기적으로 씁니다.Writes a character followed by a line terminator asynchronously to the text string or stream.

WriteLineAsync(Char[]) WriteLineAsync(Char[]) WriteLineAsync(Char[]) WriteLineAsync(Char[])

문자의 배열과 줄 종결자를 차례로 텍스트 문자열 또는 스트림에 비동기적으로 씁니다.Writes an array of characters followed by a line terminator asynchronously to the text string or stream.

WriteLineAsync(Char[], Int32, Int32) WriteLineAsync(Char[], Int32, Int32) WriteLineAsync(Char[], Int32, Int32) WriteLineAsync(Char[], Int32, Int32)

문자의 하위 배열과 줄 종결자를 차례로 텍스트 문자열 또는 스트림에 비동기적으로 씁니다.Writes a subarray of characters followed by a line terminator asynchronously to the text string or stream.

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken) WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken) WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken) WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)
WriteLineAsync(String) WriteLineAsync(String) WriteLineAsync(String) WriteLineAsync(String)

문자열과 줄 종결자를 차례로 텍스트 문자열 또는 스트림에 비동기적으로 씁니다.Writes a string followed by a line terminator asynchronously to the text string or stream.

WriteLineAsync(StringBuilder, CancellationToken) WriteLineAsync(StringBuilder, CancellationToken) WriteLineAsync(StringBuilder, CancellationToken) WriteLineAsync(StringBuilder, CancellationToken)

명시적 인터페이스 구현

IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose()

이 멤버에 대한 설명은 Dispose()를 참조하십시오.For a description of this member, see Dispose().

적용 대상

추가 정보