XmlWriter 클래스

정의

네임스페이스:

System.Xml

어셈블리:

System.Xml.ReaderWriter.dll

Source:

XmlWriter.cs

XML 데이터가 포함된 스트림 또는 파일을 생성하는 빠르고 캐시가 아닌 전달 전용 방법을 제공하는 기록기를 나타냅니다.

public ref class XmlWriter abstract : IAsyncDisposable, IDisposable

public abstract class XmlWriter : IAsyncDisposable, IDisposable

type XmlWriter = class
    interface IAsyncDisposable
    interface IDisposable

Public MustInherit Class XmlWriter
Implements IAsyncDisposable, IDisposable

상속

Object

XmlWriter

파생

System.Xml.XmlDictionaryWriter

System.Xml.XmlTextWriter

System.Xml.Xsl.Runtime.XmlQueryOutput

구현

IDisposable IAsyncDisposable

예제

다음 예제 코드에서는 비동기 API를 사용하여 XML을 생성하는 방법을 보여줍니다.

async Task TestWriter(Stream stream)
{
    XmlWriterSettings settings = new XmlWriterSettings();
    settings.Async = true;

    using (XmlWriter writer = XmlWriter.Create(stream, settings)) {
        await writer.WriteStartElementAsync("pf", "root", "http://ns");
        await writer.WriteStartElementAsync(null, "sub", null);
        await writer.WriteAttributeStringAsync(null, "att", null, "val");
        await writer.WriteStringAsync("text");
        await writer.WriteEndElementAsync();
        await writer.WriteProcessingInstructionAsync("pName", "pValue");
        await writer.WriteCommentAsync("cValue");
        await writer.WriteCDataAsync("cdata value");
        await writer.WriteEndElementAsync();
        await writer.FlushAsync();
    }
}

설명

이 API에 대한 자세한 내용은 XmlWriter대한 추가 API 비고를 참조하세요.

생성자

XmlWriter()

XmlWriter 클래스의 새 인스턴스를 초기화합니다.

속성

Settings	이 XmlWriter 인스턴스를 만드는 데 사용되는 XmlWriterSettings 개체를 가져옵니다.
WriteState	파생 클래스에서 재정의되는 경우 작성기의 상태를 가져옵니다.
XmlLang	파생 클래스에서 재정의되는 경우 현재 xml:lang 범위를 가져옵니다.
XmlSpace	파생 클래스에서 재정의되는 경우 현재 xml:space 범위를 나타내는 XmlSpace 가져옵니다.

메서드

Close()	파생 클래스에서 재정의된 경우 이 스트림과 기본 스트림을 닫습니다.
Create(Stream)	지정된 스트림을 사용하여 새 XmlWriter 인스턴스를 만듭니다.
Create(Stream, XmlWriterSettings)	스트림 및 XmlWriterSettings 개체를 사용하여 새 XmlWriter 인스턴스를 만듭니다.
Create(String)	지정된 파일 이름을 사용하여 새 XmlWriter 인스턴스를 만듭니다.
Create(String, XmlWriterSettings)	파일 이름 및 XmlWriterSettings 개체를 사용하여 새 XmlWriter 인스턴스를 만듭니다.
Create(StringBuilder)	지정된 StringBuilder사용하여 새 XmlWriter 인스턴스를 만듭니다.
Create(StringBuilder, XmlWriterSettings)	StringBuilder 및 XmlWriterSettings 개체를 사용하여 새 XmlWriter 인스턴스를 만듭니다.
Create(TextWriter)	지정된 TextWriter사용하여 새 XmlWriter 인스턴스를 만듭니다.
Create(TextWriter, XmlWriterSettings)	TextWriter 및 XmlWriterSettings 개체를 사용하여 새 XmlWriter 인스턴스를 만듭니다.
Create(XmlWriter)	지정된 XmlWriter 개체를 사용하여 새 XmlWriter 인스턴스를 만듭니다.
Create(XmlWriter, XmlWriterSettings)	지정된 XmlWriter 및 XmlWriterSettings 개체를 사용하여 새 XmlWriter 인스턴스를 만듭니다.
Dispose()	XmlWriter 클래스의 현재 인스턴스에서 사용하는 모든 리소스를 해제합니다.
Dispose(Boolean)	XmlWriter 사용하는 관리되지 않는 리소스를 해제하고 필요에 따라 관리되는 리소스를 해제합니다.
DisposeAsync()	관리되지 않는 리소스를 비동기적으로 해제, 해제 또는 다시 설정과 관련된 애플리케이션 정의 작업을 수행합니다.
DisposeAsyncCore()	관리되는 리소스를 비동기적으로 해제, 해제 또는 재설정하는 것과 관련된 애플리케이션 정의 작업을 수행합니다.
Equals(Object)	지정된 개체가 현재 개체와 같은지 여부를 확인합니다. (다음에서 상속됨 Object)
Flush()	파생 클래스에서 재정의되는 경우 버퍼에 있는 모든 내용을 기본 스트림으로 플러시하고 기본 스트림도 플러시합니다.
FlushAsync()	버퍼에 있는 모든 것을 기본 스트림으로 비동기적으로 플러시하고 기본 스트림도 플러시합니다.
GetHashCode()	기본 해시 함수로 사용됩니다. (다음에서 상속됨 Object)
GetType()	현재 인스턴스의 Type 가져옵니다. (다음에서 상속됨 Object)
LookupPrefix(String)	파생 클래스에서 재정의되는 경우 네임스페이스 URI의 현재 네임스페이스 범위에 정의된 가장 가까운 접두사를 반환합니다.
MemberwiseClone()	현재 Object단순 복사본을 만듭니다. (다음에서 상속됨 Object)
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)
WriteAttributes(XmlReader, Boolean)	파생 클래스에서 재정의되는 경우 XmlReader현재 위치에 있는 모든 특성을 기록합니다.
WriteAttributesAsync(XmlReader, Boolean)	XmlReader현재 위치에 있는 모든 특성을 비동기적으로 씁니다.
WriteAttributeString(String, String)	파생 클래스에서 재정의되는 경우 지정된 로컬 이름과 값을 사용하여 특성을 씁니다.
WriteAttributeString(String, String, String)	파생 클래스에서 재정의되는 경우 지정된 로컬 이름, 네임스페이스 URI 및 값을 사용하여 특성을 씁니다.
WriteAttributeString(String, String, String, String)	파생 클래스에서 재정의된 경우 지정된 접두사, 로컬 이름, 네임스페이스 URI 및 값을 사용하여 특성을 씁니다.
WriteAttributeStringAsync(String, String, String, String)	지정된 접두사, 로컬 이름, 네임스페이스 URI 및 값을 사용하여 특성을 비동기적으로 작성합니다.
WriteBase64(Byte[], Int32, Int32)	파생 클래스에서 재정의되는 경우 지정된 이진 바이트를 Base64로 인코딩하고 결과 텍스트를 씁니다.
WriteBase64Async(Byte[], Int32, Int32)	지정된 이진 바이트를 Base64로 비동기적으로 인코딩하고 결과 텍스트를 씁니다.
WriteBinHex(Byte[], Int32, Int32)	파생 클래스에서 재정의되는 경우 지정된 이진 바이트를 BinHex 인코딩하고 결과 텍스트를 씁니다.
WriteBinHexAsync(Byte[], Int32, Int32)	지정된 이진 바이트를 BinHex 비동기적으로 인코딩하고 결과 텍스트를 씁니다.
WriteCData(String)	파생 클래스에서 재정의되는 경우 <작성합니다. [CDATA[...]] 지정된 텍스트를 포함하는> 블록입니다.
WriteCDataAsync(String)	비동기적으로 <씁니다! [CDATA[...]] 지정된 텍스트를 포함하는> 블록입니다.
WriteCharEntity(Char)	파생 클래스에서 재정의되는 경우 지정된 유니코드 문자 값에 대한 문자 엔터티를 강제로 생성합니다.
WriteCharEntityAsync(Char)	지정된 유니코드 문자 값에 대한 문자 엔터티 생성을 비동기적으로 강제합니다.
WriteChars(Char[], Int32, Int32)	파생 클래스에서 재정의되는 경우 한 번에 하나의 버퍼 텍스트를 씁니다.
WriteCharsAsync(Char[], Int32, Int32)	한 번에 하나의 버퍼 텍스트를 비동기적으로 씁니다.
WriteComment(String)	파생 클래스에서 재정의되는 경우 지정된 텍스트가 포함된 주석 <!--...--> 작성합니다.
WriteCommentAsync(String)	지정된 텍스트가 포함된 주석 <!--...--> 비동기적으로 작성합니다.
WriteDocType(String, String, String, String)	파생 클래스에서 재정의되는 경우 지정된 이름 및 선택적 특성을 사용하여 DOCTYPE 선언을 작성합니다.
WriteDocTypeAsync(String, String, String, String)	지정된 이름 및 선택적 특성을 사용하여 DOCTYPE 선언을 비동기적으로 작성합니다.
WriteElementString(String, String)	지정된 로컬 이름과 값을 가진 요소를 씁니다.
WriteElementString(String, String, String)	지정된 로컬 이름, 네임스페이스 URI 및 값을 사용하여 요소를 씁니다.
WriteElementString(String, String, String, String)	지정된 접두사, 로컬 이름, 네임스페이스 URI 및 값을 사용하여 요소를 씁니다.
WriteElementStringAsync(String, String, String, String)	지정된 접두사, 로컬 이름, 네임스페이스 URI 및 값을 사용하여 요소를 비동기적으로 작성합니다.
WriteEndAttribute()	파생 클래스에서 재정의된 경우 이전 WriteStartAttribute(String, String) 호출을 닫습니다.
WriteEndAttributeAsync()	이전 WriteStartAttribute(String, String) 호출을 비동기적으로 닫습니다.
WriteEndDocument()	파생 클래스에서 재정의된 경우 열려 있는 요소 또는 특성을 닫고 기록기를 다시 시작 상태로 만듭니다.
WriteEndDocumentAsync()	열려 있는 요소 또는 특성을 비동기적으로 닫고 기록기를 다시 시작 상태로 만듭니다.
WriteEndElement()	파생 클래스에서 재정의된 경우 하나의 요소를 닫고 해당 네임스페이스 범위를 팝합니다.
WriteEndElementAsync()	하나의 요소를 비동기적으로 닫고 해당 네임스페이스 범위를 팝합니다.
WriteEntityRef(String)	파생 클래스에서 재정의되는 경우 엔터티 참조를 &name;씁니다.
WriteEntityRefAsync(String)	엔터티 참조를 &name;비동기적으로 씁니다.
WriteFullEndElement()	파생 클래스에서 재정의된 경우 하나의 요소를 닫고 해당 네임스페이스 범위를 팝합니다.
WriteFullEndElementAsync()	하나의 요소를 비동기적으로 닫고 해당 네임스페이스 범위를 팝합니다.
WriteName(String)	파생 클래스에서 재정의된 경우 지정된 이름을 작성하여 W3C XML 1.0 권장 사항(https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name)에 따라 유효한 이름이 되도록 합니다.
WriteNameAsync(String)	지정된 이름을 비동기적으로 작성하여 W3C XML 1.0 권장 사항(https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name)에 따라 유효한 이름이 되도록 합니다.
WriteNmToken(String)	파생 클래스에서 재정의된 경우 지정된 이름을 작성하여 W3C XML 1.0 권장 사항(https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name)에 따라 유효한 NmToken인지 확인합니다.
WriteNmTokenAsync(String)	지정된 이름을 비동기적으로 작성하여 W3C XML 1.0 권장 사항(https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name)에 따라 유효한 NmToken인지 확인합니다.
WriteNode(XmlReader, Boolean)	파생 클래스에서 재정의된 경우 판독기에서 작성기에 이르기까지 모든 항목을 복사하고 판독기를 다음 형제의 시작으로 이동합니다.
WriteNode(XPathNavigator, Boolean)	XPathNavigator 개체에서 작성기에 모든 항목을 복사합니다. XPathNavigator 위치는 변경되지 않습니다.
WriteNodeAsync(XmlReader, Boolean)	판독기에서 작성기에 이르기까지 모든 항목을 비동기적으로 복사하고 판독기를 다음 형제의 시작으로 이동합니다.
WriteNodeAsync(XPathNavigator, Boolean)	XPathNavigator 개체에서 작성기에 이르기까지 모든 항목을 비동기적으로 복사합니다. XPathNavigator 위치는 변경되지 않습니다.
WriteProcessingInstruction(String, String)	파생 클래스에서 재정의되는 경우 이름 및 텍스트 사이에 공백이 있는 처리 명령을 다음과 같이 기록합니다. <?name text?>.
WriteProcessingInstructionAsync(String, String)	이름과 텍스트 사이에 공백이 있는 처리 명령을 다음과 같이 비동기적으로 작성합니다. <?name text?>.
WriteQualifiedName(String, String)	파생 클래스에서 재정의되는 경우 네임스페이스로 한정된 이름을 씁니다. 이 메서드는 지정된 네임스페이스에 대한 범위에 있는 접두사를 찾습니다.
WriteQualifiedNameAsync(String, String)	네임스페이스 정규화된 이름을 비동기적으로 작성합니다. 이 메서드는 지정된 네임스페이스에 대한 범위에 있는 접두사를 찾습니다.
WriteRaw(Char[], Int32, Int32)	파생 클래스에서 재정의되는 경우 문자 버퍼에서 원시 태그를 수동으로 씁니다.
WriteRaw(String)	파생 클래스에서 재정의되는 경우 문자열에서 원시 태그를 수동으로 씁니다.
WriteRawAsync(Char[], Int32, Int32)	문자 버퍼에서 원시 태그를 수동으로 비동기적으로 작성합니다.
WriteRawAsync(String)	문자열에서 원시 태그를 수동으로 비동기적으로 씁니다.
WriteStartAttribute(String)	지정된 로컬 이름을 사용하여 특성의 시작을 씁니다.
WriteStartAttribute(String, String)	지정된 로컬 이름 및 네임스페이스 URI를 사용하여 특성의 시작을 씁니다.
WriteStartAttribute(String, String, String)	파생 클래스에서 재정의되는 경우 지정된 접두사, 로컬 이름 및 네임스페이스 URI를 사용하여 특성의 시작을 씁니다.
WriteStartAttributeAsync(String, String, String)	지정된 접두사, 로컬 이름 및 네임스페이스 URI를 사용하여 특성의 시작을 비동기적으로 씁니다.
WriteStartDocument()	파생 클래스에서 재정의되는 경우 버전 "1.0"을 사용하여 XML 선언을 작성합니다.
WriteStartDocument(Boolean)	파생 클래스에서 재정의되는 경우 버전 "1.0"과 독립 실행형 특성을 사용하여 XML 선언을 작성합니다.
WriteStartDocumentAsync()	버전 "1.0"을 사용하여 XML 선언을 비동기적으로 작성합니다.
WriteStartDocumentAsync(Boolean)	버전 "1.0"과 독립 실행형 특성을 사용하여 XML 선언을 비동기적으로 작성합니다.
WriteStartElement(String)	파생 클래스에서 재정의되는 경우 지정된 로컬 이름을 사용하여 시작 태그를 작성합니다.
WriteStartElement(String, String)	파생 클래스에서 재정의된 경우 지정된 시작 태그를 작성하고 지정된 네임스페이스와 연결합니다.
WriteStartElement(String, String, String)	파생 클래스에서 재정의되는 경우 지정된 시작 태그를 작성하고 지정된 네임스페이스 및 접두사에 연결합니다.
WriteStartElementAsync(String, String, String)	지정된 시작 태그를 비동기적으로 작성하고 지정된 네임스페이스 및 접두사에 연결합니다.
WriteString(String)	파생 클래스에서 재정의되는 경우 지정된 텍스트 콘텐츠를 씁니다.
WriteStringAsync(String)	지정된 텍스트 콘텐츠를 비동기적으로 씁니다.
WriteSurrogateCharEntity(Char, Char)	파생 클래스에서 재정의되는 경우 서로게이트 문자 쌍에 대한 서로게이트 문자 엔터티를 생성하고 씁니다.
WriteSurrogateCharEntityAsync(Char, Char)	서로게이트 문자 쌍에 대한 서로게이트 문자 엔터티를 비동기적으로 생성하고 씁니다.
WriteValue(Boolean)	Boolean 값을 씁니다.
WriteValue(DateTime)	DateTime 값을 씁니다.
WriteValue(DateTimeOffset)	DateTimeOffset 값을 씁니다.
WriteValue(Decimal)	Decimal 값을 씁니다.
WriteValue(Double)	Double 값을 씁니다.
WriteValue(Int32)	Int32 값을 씁니다.
WriteValue(Int64)	Int64 값을 씁니다.
WriteValue(Object)	개체 값을 씁니다.
WriteValue(Single)	단정밀도 부동 소수점 숫자를 씁니다.
WriteValue(String)	String 값을 씁니다.
WriteWhitespace(String)	파생 클래스에서 재정의되는 경우 지정된 공백을 씁니다.
WriteWhitespaceAsync(String)	지정된 공백을 비동기적으로 작성합니다.

확장 메서드

ConfigureAwait(IAsyncDisposable, Boolean)

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

추가 정보

• XML 문서 및 데이터