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)	스트림과 XmlWriter 개체를 사용하여 새 XmlWriterSettings 인스턴스를 만듭니다.
Create(String)	지정된 파일 이름을 사용하여 새 XmlWriter 인스턴스를 만듭니다.
Create(String, XmlWriterSettings)	파일 이름과 XmlWriter 개체를 사용하여 새 XmlWriterSettings 인스턴스를 만듭니다.
Create(StringBuilder)	지정된 XmlWriter를 사용하여 새 StringBuilder 인스턴스를 만듭니다.
Create(StringBuilder, XmlWriterSettings)	XmlWriter 및 StringBuilder 개체를 사용하여 새 XmlWriterSettings 인스턴스를 만듭니다.
Create(TextWriter)	지정된 XmlWriter를 사용하여 새 TextWriter 인스턴스를 만듭니다.
Create(TextWriter, XmlWriterSettings)	XmlWriter 및 TextWriter 개체를 사용하여 새 XmlWriterSettings 인스턴스를 만듭니다.
Create(XmlWriter)	지정된 XmlWriter 개체를 사용하여 새 XmlWriter 인스턴스를 만듭니다.
Create(XmlWriter, XmlWriterSettings)	지정된 XmlWriter 및 XmlWriter 개체를 사용하여 새 XmlWriterSettings 인스턴스를 만듭니다.
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 문서 및 데이터