XmlWriter 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
XML 데이터가 포함된 스트림 또는 파일을 생성할 수 있도록 빠르고, 앞으로만 이동 가능하고, 캐시되지 않은 방법을 제공하는 작성기를 나타냅니다.
public ref class XmlWriter abstract : IDisposable
public ref class XmlWriter abstract : IAsyncDisposable, IDisposable
public ref class XmlWriter abstract
public abstract class XmlWriter : IDisposable
public abstract class XmlWriter : IAsyncDisposable, IDisposable
public abstract class XmlWriter
type XmlWriter = class
interface IDisposable
type XmlWriter = class
interface IAsyncDisposable
interface IDisposable
type XmlWriter = class
Public MustInherit Class XmlWriter
Implements IDisposable
Public MustInherit Class XmlWriter
Implements IAsyncDisposable, IDisposable
Public MustInherit Class XmlWriter
- 상속
-
XmlWriter
- 파생
- 구현
예제
다음 예제 코드에서는 비동기 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 |
파생 클래스에서 재정의되면 현재 |
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) | |
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) |
파생 클래스에서 재정의되면 지정된 이진 바이트를 |
WriteBinHexAsync(Byte[], Int32, Int32) |
지정된 바이너리 바이트를 |
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) |
파생 클래스에서 재정의되면 |
WriteEntityRefAsync(String) |
엔터티 참조를 |
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) |
주어진 공백을 비동기적으로 작성합니다. |
명시적 인터페이스 구현
IDisposable.Dispose() |
이 멤버에 대한 설명은 Dispose()를 참조하세요. |
확장 메서드
ConfigureAwait(IAsyncDisposable, Boolean) |
비동기 일회용에서 반환되는 작업을 대기하는 방법을 구성합니다. |
적용 대상
추가 정보
.NET
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기