XmlWriter 클래스

정의

XML 데이터가 포함된 스트림 또는 파일을 생성할 수 있도록 빠르고, 앞으로만 이동 가능하고, 캐시되지 않은 방법을 제공하는 작성기를 나타냅니다.Represents a writer that provides a fast, non-cached, forward-only way to generate streams or files that contain XML data.

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 IDisposable
    interface IAsyncDisposable
type XmlWriter = class
Public MustInherit Class XmlWriter
Implements IDisposable
Public MustInherit Class XmlWriter
Implements IAsyncDisposable, IDisposable
Public MustInherit Class XmlWriter
상속
XmlWriter
파생
구현

예제

다음 예제 코드에서는 비동기 API를 사용 하 여 XML을 생성 하는 방법을 보여 줍니다.The following example code shows how to use the asynchronous API to generate 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();  
    }  
}  

설명

XmlWriter클래스는 스트림, 파일, 텍스트 판독기 또는 문자열에 XML 데이터를 씁니다.The XmlWriter class writes XML data to a stream, file, text reader, or string. W3C XML(Extensible Markup Language) (xml) 1.0 (넷째 버전)xml 1.0 (셋째 버전) 권장 사항의 네임 스페이스 를 지원 합니다.It supports the W3C Extensible Markup Language (XML) 1.0 (fourth edition) and Namespaces in XML 1.0 (third edition) recommendations.

클래스의 멤버를 XmlWriter 사용 하 여 다음 작업을 수행할 수 있습니다.The members of the XmlWriter class enable you to:

  • 문자가 올바른 XML 문자 인지와 요소 및 특성 이름이 유효한 XML 이름 인지 확인 합니다.Verify that the characters are legal XML characters and that element and attribute names are valid XML names.

  • XML 문서가 제대로 구성 되어 있는지 확인 합니다.Verify that the XML document is well-formed.

  • Binary 바이트를 Base64 또는 BinHex로 인코딩하고 결과 텍스트를 작성 합니다.Encode binary bytes as Base64 or BinHex, and write out the resulting text.

  • 값을 수동으로 변환할 필요가 없도록 문자열 대신 공용 언어 런타임 형식을 사용 하 여 값을 전달 합니다.Pass values by using common language runtime types instead of strings, to avoid having to manually perform value conversions.

  • 하나의 출력 스트림에 여러 문서를 씁니다.Write multiple documents to one output stream.

  • 유효한 이름, 정규화 된 이름 및 이름 토큰을 씁니다.Write valid names, qualified names, and name tokens.

이 섹션에서는 다음 작업을 수행합니다.In this section:

XML 작성기 만들기 Creating an XML writer
출력 형식 지정 Specifying the output format
데이터 규칙 Data conformance
요소 작성 Writing elements
특성 쓰기 Writing attributes
네임 스페이스 처리 Handling namespaces
형식화 된 데이터 작성 Writing typed data
XML 작성기 닫기 Closing the XML writer
비동기 프로그래밍 Asynchronous programming
보안 고려 사항Security considerations

XML 작성기 만들기Creating an XML writer

인스턴스를 만들려면 XmlWriter 메서드를 사용 XmlWriter.Create 합니다.To create an XmlWriter instance, use the XmlWriter.Create method. XML 작성기에서 사용할 기능 집합을 지정 하려면를 XmlWriterSettings Create 메서드에 전달 합니다.To specify the set of features you want to enable on the XML writer, pass an XmlWriterSettings to the Create method. 그렇지 않으면 기본 설정이 사용 됩니다.Otherwise, default settings are used. 자세한 내용은 Create 참조 페이지를 참조 하세요.See the Create reference pages for details.

출력 형식 지정Specifying the output format

클래스에는 XmlWriterSettings XmlWriter 출력의 형식을 지정 하는 방법을 제어 하는 여러 속성이 포함 되어 있습니다.The XmlWriterSettings class includes several properties that control how XmlWriter output is formatted:

속성Property 설명Description
Encoding 사용할 텍스트 인코딩을 지정 합니다.Specifies the text encoding to use. 기본값은 Encoding.UTF8입니다.The default is Encoding.UTF8.
Indent 요소를 들여쓸 것인지 여부를 나타냅니다.Indicates whether to indent elements. 기본값은 false (들여쓰기 안 함)입니다.The default is false (no indentation).
IndentChars 들여쓰기에 사용할 문자열을 지정 합니다.Specifies the character string to use when indenting. 기본값은 공백 두 개입니다.The default is two spaces.
NewLineChars 줄 바꿈에 사용할 문자열을 지정 합니다.Specifies the character string to use for line breaks. 기본값은 \r\n (캐리지 리턴, 줄 바꿈)입니다.The default is \r\n (carriage return, line feed).
NewLineHandling 줄 바꿈 문자를 처리 하는 방법을 지정 합니다.Specifies how to handle newline characters.
NewLineOnAttributes 특성을 새 줄에 쓸지 여부를 나타냅니다.Indicates whether to write attributes on a new line. Indent 이 속성을 사용 하는 경우를로 설정 해야 합니다 true .Indent should be set to true when using this property. 기본값은 false입니다.The default is false.
OmitXmlDeclaration XML 선언을 쓸지 여부를 나타냅니다.Indicates whether to write an XML declaration. 기본값은 false입니다.The default is false.

IndentIndentChars 속성은 무효 공백 형식이 지정 되는 방식을 제어 합니다.The Indent and IndentChars properties control how insignificant white space is formatted. 예를 들어 요소 노드를 들여쓰려면 다음과 같이 합니다.For example, to indent element nodes:

XmlWriterSettings settings = new XmlWriterSettings();
settings.Indent = true;
settings.IndentChars = "\t";
XmlWriter writer = XmlWriter.Create("books.xml", settings);
Dim settings As New XmlWriterSettings()
settings.Indent = True
settings.IndentChars = vbTab
Dim writer As XmlWriter = XmlWriter.Create("books.xml", settings)

를 사용 NewLineOnAttributes 하 여 각 특성을 추가 수준의 들여쓰기를 사용 하 여 새 줄에 씁니다.Use the NewLineOnAttributes to write each attribute on a new line with one extra level of indentation:

XmlWriterSettings settings = new XmlWriterSettings();
settings.Indent = true;
settings.NewLineOnAttributes = true;
XmlWriter writer = XmlWriter.Create("books.xml", settings);
Dim settings As New XmlWriterSettings()
settings.Indent = True
settings.NewLineOnAttributes = True
Dim writer As XmlWriter = XmlWriter.Create("books.xml", settings)

데이터 규칙Data conformance

XML 작성기는 클래스의 두 가지 속성을 사용 하 여 XmlWriterSettings 데이터 규칙을 검사 합니다.An XML writer uses two properties from the XmlWriterSettings class to check for data conformance:

  • CheckCharacters속성은 W3C에서 정의한 대로 문자를 확인 하 고 XmlException 잘못 된 범위 밖에 있는 경우 예외를 THROW 하도록 XML 작성기에 지시 합니다.The CheckCharacters property instructs the XML writer to check characters and throw an XmlException exception if any characters are outside the legal range, as defined by the W3C.

  • ConformanceLevel속성은 작성 중인 스트림이 W3C에서 정의한 대로 올바른 형식의 xml 1.0 문서 또는 문서 조각에 대 한 규칙을 준수 하는지 확인 하도록 XML 작성기를 구성 합니다.The ConformanceLevel property configures the XML writer to check that the stream being written complies with the rules for a well-formed XML 1.0 document or document fragment, as defined by the W3C. 다음 표에서는 세 가지 규칙 수준에 대해 설명 합니다.The three conformance levels are described in the following table. 기본값은 Document입니다.The default is Document. 자세한 내용은 XmlWriterSettings.ConformanceLevel 속성 및 열거형을 참조 하세요 System.Xml.ConformanceLevel .For details, see the XmlWriterSettings.ConformanceLevel property and the System.Xml.ConformanceLevel enumeration.

    LevelLevel 설명Description
    Document XML 출력은 올바른 형식의 XML 1.0 문서에 대 한 규칙을 준수 하며 모든 규격 프로세서에서 처리할 수 있습니다.The XML output conforms to the rules for a well-formed XML 1.0 document and can be processed by any conforming processor.
    Fragment XML 출력은 올바른 형식의 XML 1.0 문서 조각에 대 한 규칙을 따릅니다.The XML output conforms to the rules for a well-formed XML 1.0 document fragment.
    Auto XML 작성기는 들어오는 데이터를 기반으로 적용 (문서 또는 조각) 할 수 있는 검사 수준을 결정 합니다.The XML writer determines which level of conformation checking to apply (document or fragment) based on the incoming data.

요소 작성Writing elements

다음 메서드를 사용 XmlWriter 하 여 요소 노드를 작성할 수 있습니다.You can use the following XmlWriter methods to write element nodes. 예제는 나열 된 메서드를 참조 하세요.For examples, see the methods listed.

기능Use 대상To
WriteElementString 문자열 값을 포함 하 여 전체 요소 노드를 작성 합니다.Write an entire element node, including a string value.
WriteStartElement 여러 메서드 호출을 사용 하 여 요소 값을 쓰려면입니다.To write an element value by using multiple method calls. 예를 들어를 호출 WriteValue 하 여 형식화 된 값을 쓰거나, WriteCharEntity 문자 엔터티를 작성 하거나, 특성을 WriteAttributeString 작성 하거나, 자식 요소를 작성할 수 있습니다.For example, you can call WriteValue to write a typed value, WriteCharEntity to write a character entity, WriteAttributeString to write an attribute, or you can write a child element. 이는 보다 정교한 버전의 WriteElementString 메서드입니다.This is a more sophisticated version of the WriteElementString method.

요소를 닫으려면 WriteEndElement 또는 메서드를 호출 WriteFullEndElement 합니다.To close the element, you call the WriteEndElement or WriteFullEndElement method.
WriteNode 또는 개체의 현재 위치에 있는 요소 노드를 복사 XmlReader XPathNavigator 합니다.To copy an element node found at the current position of an XmlReader or XPathNavigator object. 호출 될 때 원본 개체에서 인스턴스로 모든 항목을 복사 XmlWriter 합니다.When called, it copies everything from the source object to the XmlWriter instance.

특성 쓰기Writing attributes

다음 메서드를 사용 하 여 XmlWriter 요소 노드에 특성을 쓸 수 있습니다.You can use the following XmlWriter methods to write attributes on element nodes. 다음 섹션에서 설명 하는 것 처럼 이러한 메서드를 사용 하 여 요소에 대 한 네임 스페이스 선언을 만들 수도 있습니다.These methods can also be used to create namespace declarations on an element, as discussed in the next section.

기능Use 대상To
WriteAttributeString 문자열 값을 포함 하 여 전체 특성 노드를 작성 합니다.To write an entire attribute node, including a string value.
WriteStartAttribute 여러 메서드 호출을 사용 하 여 특성 값을 쓰려면입니다.To write the attribute value using multiple method calls. 예를 들어 WriteValue 를 호출 하 여 형식화 된 값을 쓸 수 있습니다.For example, you can call WriteValue to write a typed value. 이는 보다 정교한 버전의 WriteElementString 메서드입니다.This is a more sophisticated version of the WriteElementString method.

요소를 닫으려면 메서드를 호출 WriteEndAttribute 합니다.To close the element, you call the WriteEndAttribute method.
WriteAttributes 개체의 현재 위치에 있는 모든 특성을 복사 하려면 XmlReader 입니다.To copy all the attributes found at the current position of an XmlReader object. 작성 되는 특성은 판독기가 현재 위치한 노드의 형식에 따라 달라 집니다.The attributes that are written depend on the type of node the reader is currently positioned on:

-특성 노드의 경우 현재 특성을 쓴 다음 요소 닫는 태그까지 나머지 특성을 씁니다.- For an attribute node, it writes the current attribute, and then the rest of the attributes until the element closing tag.
-요소 노드의 경우 요소에 포함 된 모든 특성을 작성 합니다.- For an element node, it writes all attributes contained by the element.
-XML 선언 노드의 경우 선언에 모든 특성을 씁니다.- For an XML declaration node, it writes all the attributes in the declaration.
-다른 모든 노드 형식의 경우 메서드는 예외를 throw 합니다.- For all other node types, the method throws an exception.

네임 스페이스 처리Handling namespaces

네임 스페이스는 XML 문서에서 요소 및 특성 이름을 정규화 하는 데 사용 됩니다.Namespaces are used to qualify element and attribute names in an XML document. 네임 스페이스 접두사는 요소와 특성을 네임 스페이스와 연결 합니다 .이 네임 스페이스는 다시 URI 참조와 연결 됩니다.Namespace prefixes associate elements and attributes with namespaces, which are in turn associated with URI references. 네임 스페이스는 XML 문서에서 요소 및 특성 이름을 고유 하 게 만듭니다.Namespaces create element and attribute name uniqueness in an XML document.

XmlWriter 현재 네임 스페이스 범위에 정의 된 모든 네임 스페이스에 해당 하는 네임 스페이스 스택을 유지 관리 합니다.The XmlWriter maintains a namespace stack that corresponds to all the namespaces defined in the current namespace scope. 요소와 특성을 작성할 때 다음과 같은 방법으로 네임 스페이스를 활용할 수 있습니다.When writing elements and attributes you can utilize namespaces in the following ways:

  • 메서드를 사용 하 여 네임 스페이스를 수동으로 선언 WriteAttributeString 합니다.Declare namespaces manually by using the WriteAttributeString method. 이는 네임 스페이스 선언 수를 최적으로 최적화 하는 방법을 알고 있는 경우에 유용할 수 있습니다.This can be useful when you know how to best optimize the number of namespace declarations. 예를 들어 참조 된 WriteAttributeString(String, String, String, String) 메서드.For an example, see the WriteAttributeString(String, String, String, String) method.

  • 현재 네임 스페이스 선언을 새 네임 스페이스로 재정의 합니다.Override the current namespace declaration with a new namespace. 다음 코드에서 WriteAttributeString 메서드는 접두사의 네임 스페이스 URI를 "x" 에서로 변경 "123" "abc" 합니다.In the following code, the WriteAttributeString method changes the namespace URI for the "x" prefix from "123" to "abc".

    writer.WriteStartElement("x", "root", "123");
    writer.WriteStartElement("item");
    writer.WriteAttributeString("xmlns", "x", null, "abc");
    writer.WriteEndElement();
    writer.WriteEndElement();
    
    writer.WriteStartElement("x", "root", "123")
    writer.WriteStartElement("item")
    writer.WriteAttributeString("xmlns", "x", Nothing, "abc")
    writer.WriteEndElement()
    writer.WriteEndElement()
    

    이 코드는 다음 XML 문자열을 생성 합니다.The code generates the following XML string:

    <x:root xmlns:x="123">  
      <item xmlns:x="abc" />  
    </x:root>  
    
  • 특성 또는 요소를 작성할 때 네임 스페이스 접두사를 지정 합니다.Specify a namespace prefix when writing attributes or elements. 요소와 특성을 작성 하는 데 사용 되는 대부분의 메서드는이 작업을 수행할 수 있습니다.Many of the methods used to write element and attributes enable you to do this. 예를 들어 WriteStartElement(String, String, String) 메서드는 시작 태그를 작성 하 고 지정 된 네임 스페이스 및 접두사와 연결 합니다.For example, the WriteStartElement(String, String, String) method writes a start tag and associates it with a specified namespace and prefix.

형식화 된 데이터 작성Writing typed data

WriteValue메서드는 CLR (공용 언어 런타임) 개체를 수락 하 고, XSD (XML 스키마 정의 언어) 데이터 형식 변환 규칙에 따라 입력 값을 문자열 표현으로 변환 하 고, 메서드를 사용 하 여 출력을 작성 합니다 WriteString .The WriteValue method accepts a common language runtime (CLR) object, converts the input value to its string representation according to XML schema definition language (XSD) data type conversion rules, and writes it out by using the WriteString method. 이는 쓰기 전에 클래스의 메서드를 사용 하 여 XmlConvert 형식화 된 데이터를 문자열 값으로 변환 하는 것 보다 쉽습니다.This is easier than using the methods in the XmlConvert class to convert the typed data to a string value before writing it out.

텍스트에 쓰는 경우 XmlConvert 해당 스키마 형식에 대 한 규칙을 사용 하 여 형식화 된 값이 텍스트로 serialize 됩니다.When writing to text, the typed value is serialized to text by using the XmlConvert rules for that schema type.

CLR 형식에 해당 하는 기본 XSD 데이터 형식의 경우 메서드를 참조 하세요 WriteValue .For default XSD data types that correspond to CLR types, see the WriteValue method.

XmlWriter 사용 하 여 XML 데이터 저장소에 쓸 수도 있습니다.The XmlWriter can also be used to write to an XML data store. 예를 들어 클래스는 개체를 XPathNavigator 만들어 XmlWriter 개체에 대 한 노드를 만들 수 있습니다 XmlDocument .For example, the XPathNavigator class can create an XmlWriter object to create nodes for an XmlDocument object. 데이터 저장소에 사용 가능한 스키마 정보가 있는 경우 WriteValue 허용 되지 않는 형식으로 변환 하려고 하면 메서드에서 예외가 throw 됩니다.If the data store has schema information available to it, the WriteValue method throws an exception if you try to convert to a type that is not allowed. 데이터 저장소에 사용 가능한 스키마 정보가 없는 경우 WriteValue 메서드는 모든 값을 형식으로 처리 합니다 xsd:anySimpleType .If the data store does not have schema information available to it, the WriteValue method treats all values as an xsd:anySimpleType type.

XML 작성기 닫기Closing the XML writer

메서드를 사용 하 여 XML을 출력 하는 경우에는 XmlWriter 메서드를 호출할 때까지 요소와 특성이 작성 되지 않습니다 Close .When you use XmlWriter methods to output XML, the elements and attributes are not written until you call the Close method. 예를 들어를 사용 하 여 XmlWriter 개체를 채우면 XmlDocument 인스턴스를 닫기 전까지 대상 문서에서 작성 된 요소 및 특성을 볼 수 없습니다 XmlWriter .For example, if you are using XmlWriter to populate an XmlDocument object, you won't be able to see the written elements and attributes in the target document until you close the XmlWriter instance.

비동기 프로그래밍Asynchronous programming

대부분의 XmlWriter 메서드에는 메서드 이름의 끝에 "Async"가 있는 비동기 대응 항목이 있습니다.Most of the XmlWriter methods have asynchronous counterparts that have "Async" at the end of their method names. 예를 들어의 비동기 값은 WriteAttributeString 입니다 WriteAttributeStringAsync .For example, the asynchronous equivalent of WriteAttributeString is WriteAttributeStringAsync.

WriteValue비동기 대응 항목이 없는 메서드의 경우 반환 값을 문자열로 변환 하 고 WriteStringAsync 메서드를 대신 사용 합니다.For the WriteValue method, which doesn't have an asynchronous counterpart, convert the return value to a string and use the WriteStringAsync method instead.

보안 고려 사항Security considerations

클래스로 작업 하는 경우 다음 사항을 고려 XmlWriter 하세요.Consider the following when working with the XmlWriter class:

  • 에서 throw 되는 예외는 XmlWriter 앱에 버블링 하지 않으려는 경로 정보를 노출할 수 있습니다.Exceptions thrown by the XmlWriter can disclose path information that you do not want bubbled up to the app. 앱에서 예외를 catch 하 고 적절 하 게 처리 해야 합니다.Your app must catch exceptions and process them appropriately.

  • XmlWriter 는 또는 메서드에 전달 된 데이터의 유효성을 검사 하지 않습니다 WriteDocType WriteRaw .XmlWriter does not validate any data that is passed to the WriteDocType or WriteRaw method. 이러한 메서드에는 임의의 데이터를 전달 하면 안 됩니다.You should not pass arbitrary data to these methods.

생성자

XmlWriter()

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

속성

Settings

XmlWriter 인스턴스를 만드는 데 사용되는 XmlWriterSettings 개체를 가져옵니다.Gets the XmlWriterSettings object used to create this XmlWriter instance.

WriteState

파생 클래스에서 재정의되면 작성기의 상태를 가져옵니다.When overridden in a derived class, gets the state of the writer.

XmlLang

파생 클래스에서 재정의되면 현재 xml:lang 범위를 가져옵니다.When overridden in a derived class, gets the current xml:lang scope.

XmlSpace

파생 클래스에서 재정의되면 현재 xml:space 범위를 나타내는 XmlSpace를 가져옵니다.When overridden in a derived class, gets an XmlSpace representing the current xml:space scope.

메서드

Close()

파생 클래스에서 재정의되면 이 스트림 및 내부 스트림을 닫습니다.When overridden in a derived class, closes this stream and the underlying stream.

Create(Stream)

지정된 스트림을 사용하여 새 XmlWriter 인스턴스를 만듭니다.Creates a new XmlWriter instance using the specified stream.

Create(Stream, XmlWriterSettings)

스트림과 XmlWriter 개체를 사용하여 새 XmlWriterSettings 인스턴스를 만듭니다.Creates a new XmlWriter instance using the stream and XmlWriterSettings object.

Create(String)

지정된 파일 이름을 사용하여 새 XmlWriter 인스턴스를 만듭니다.Creates a new XmlWriter instance using the specified filename.

Create(String, XmlWriterSettings)

파일 이름과 XmlWriter 개체를 사용하여 새 XmlWriterSettings 인스턴스를 만듭니다.Creates a new XmlWriter instance using the filename and XmlWriterSettings object.

Create(StringBuilder)

지정된 XmlWriter를 사용하여 새 StringBuilder 인스턴스를 만듭니다.Creates a new XmlWriter instance using the specified StringBuilder.

Create(StringBuilder, XmlWriterSettings)

XmlWriterStringBuilder 개체를 사용하여 새 XmlWriterSettings 인스턴스를 만듭니다.Creates a new XmlWriter instance using the StringBuilder and XmlWriterSettings objects.

Create(TextWriter)

지정된 XmlWriter를 사용하여 새 TextWriter 인스턴스를 만듭니다.Creates a new XmlWriter instance using the specified TextWriter.

Create(TextWriter, XmlWriterSettings)

XmlWriterTextWriter 개체를 사용하여 새 XmlWriterSettings 인스턴스를 만듭니다.Creates a new XmlWriter instance using the TextWriter and XmlWriterSettings objects.

Create(XmlWriter)

지정된 XmlWriter 개체를 사용하여 새 XmlWriter 인스턴스를 만듭니다.Creates a new XmlWriter instance using the specified XmlWriter object.

Create(XmlWriter, XmlWriterSettings)

지정된 XmlWriterXmlWriter 개체를 사용하여 새 XmlWriterSettings 인스턴스를 만듭니다.Creates a new XmlWriter instance using the specified XmlWriter and XmlWriterSettings objects.

Dispose()

XmlWriter 클래스의 현재 인스턴스에서 사용하는 모든 리소스를 해제합니다.Releases all resources used by the current instance of the XmlWriter class.

Dispose(Boolean)

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

DisposeAsync()

비동기적으로 관리되지 않는 리소스의 확보, 해제 또는 다시 설정과 관련된 애플리케이션 정의 작업을 수행합니다.Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources asynchronously.

DisposeAsyncCore()

비동기적으로 관리되는 리소스의 확보, 해제 또는 다시 설정과 관련된 애플리케이션 정의 작업을 수행합니다.Performs application-defined tasks associated with freeing, releasing, or resetting managed resources asynchronously.

Equals(Object)

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

(다음에서 상속됨 Object)
Flush()

파생 클래스에서 재정의되면 버퍼에 있는 항목을 내부 스트림으로 플러시하고 내부 스트림도 플러시합니다.When overridden in a derived class, flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream.

FlushAsync()

버퍼에 있는 모든 내용을 내부 스트림으로 비동기적으로 플러시하고 내부 스트림도 플러시합니다.Asynchronously flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream.

GetHashCode()

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

(다음에서 상속됨 Object)
GetType()

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

(다음에서 상속됨 Object)
LookupPrefix(String)

파생 클래스에서 재정의되면 네임스페이스 URI의 현재 네임스페이스 범위에 정의된 가장 비슷한 접두사를 반환합니다.When overridden in a derived class, returns the closest prefix defined in the current namespace scope for the namespace URI.

MemberwiseClone()

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

(다음에서 상속됨 Object)
ToString()

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

(다음에서 상속됨 Object)
WriteAttributes(XmlReader, Boolean)

파생 클래스에서 재정의되면 XmlReader의 현재 위치에 있는 모든 특성을 작성합니다.When overridden in a derived class, writes out all the attributes found at the current position in the XmlReader.

WriteAttributesAsync(XmlReader, Boolean)

XmlReader의 현재 위치에서 찾은 모든 특성을 비동기적으로 작성합니다.Asynchronously writes out all the attributes found at the current position in the XmlReader.

WriteAttributeString(String, String)

파생 클래스에서 재정의되면 지정된 로컬 이름 및 값이 있는 특성을 작성합니다.When overridden in a derived class, writes out the attribute with the specified local name and value.

WriteAttributeString(String, String, String)

파생 클래스에서 재정의되면 지정된 로컬 이름, 네임스페이스 URI 및 값을 갖는 특성을 작성합니다.When overridden in a derived class, writes an attribute with the specified local name, namespace URI, and value.

WriteAttributeString(String, String, String, String)

파생 클래스에서 재정의되면 지정된 접두사, 로컬 이름, 네임스페이스 URI 및 값을 갖는 특성을 작성합니다.When overridden in a derived class, writes out the attribute with the specified prefix, local name, namespace URI, and value.

WriteAttributeStringAsync(String, String, String, String)

지정된 접두사, 로컬 이름, 네임스페이스 URI 및 값을 사용하여 특성을 비동기적으로 작성합니다.Asynchronously writes out the attribute with the specified prefix, local name, namespace URI, and value.

WriteBase64(Byte[], Int32, Int32)

파생 클래스에서 재정의되면 지정된 이진 바이트를 Base64로 인코딩하고 결과 텍스트를 작성합니다.When overridden in a derived class, encodes the specified binary bytes as Base64 and writes out the resulting text.

WriteBase64Async(Byte[], Int32, Int32)

지정된 바이너리 바이트를 Base64로 비동기적으로 인코딩하고 결과 텍스트를 작성합니다.Asynchronously encodes the specified binary bytes as Base64 and writes out the resulting text.

WriteBinHex(Byte[], Int32, Int32)

파생 클래스에서 재정의되면 지정된 이진 바이트를 BinHex로 인코딩하고 결과 텍스트를 작성합니다.When overridden in a derived class, encodes the specified binary bytes as BinHex and writes out the resulting text.

WriteBinHexAsync(Byte[], Int32, Int32)

지정된 바이너리 바이트를 BinHex로 비동기적으로 인코딩하고 결과 텍스트를 작성합니다.Asynchronously encodes the specified binary bytes as BinHex and writes out the resulting text.

WriteCData(String)

파생 클래스에서 재정의되면 지정된 텍스트가 포함된 <![CDATA[...]]> 블록을 작성합니다.When overridden in a derived class, writes out a <![CDATA[...]]> block containing the specified text.

WriteCDataAsync(String)

지정된 텍스트를 포함하는 <![CDATA[...]]> 블록을 비동기적으로 작성합니다.Asynchronously writes out a <![CDATA[...]]> block containing the specified text.

WriteCharEntity(Char)

파생 클래스에서 재정의되면 지정된 유니코드 문자 값의 문자 엔터티를 생성하게 합니다.When overridden in a derived class, forces the generation of a character entity for the specified Unicode character value.

WriteCharEntityAsync(Char)

지정된 유니코드 문자 값에 대한 문자 엔터티가 비동기적으로 생성되도록 합니다.Asynchronously forces the generation of a character entity for the specified Unicode character value.

WriteChars(Char[], Int32, Int32)

파생 클래스에서 재정의되면 한 번에 한 버퍼씩 텍스트를 작성합니다.When overridden in a derived class, writes text one buffer at a time.

WriteCharsAsync(Char[], Int32, Int32)

한 번에 한 버퍼씩 텍스트를 비동기적으로 씁니다.Asynchronously writes text one buffer at a time.

WriteComment(String)

파생 클래스에서 재정의되면 지정된 텍스트가 포함된 주석 <!--...-->을 작성합니다.When overridden in a derived class, writes out a comment <!--...--> containing the specified text.

WriteCommentAsync(String)

지정된 텍스트를 포함하는 주석 <!--...-->을 비동기적으로 작성합니다.Asynchronously writes out a comment <!--...--> containing the specified text.

WriteDocType(String, String, String, String)

파생 클래스에서 재정의되면 지정된 이름 및 선택적 특성이 있는 DOCTYPE 선언을 작성합니다.When overridden in a derived class, writes the DOCTYPE declaration with the specified name and optional attributes.

WriteDocTypeAsync(String, String, String, String)

지정된 이름과 선택적 특성을 사용하여 DOCTYPE 선언을 비동기적으로 작성합니다.Asynchronously writes the DOCTYPE declaration with the specified name and optional attributes.

WriteElementString(String, String)

지정된 로컬 이름 및 값을 사용하여 요소를 작성합니다.Writes an element with the specified local name and value.

WriteElementString(String, String, String)

지정된 로컬 이름, 네임스페이스 URI 및 값을 사용하여 요소를 작성합니다.Writes an element with the specified local name, namespace URI, and value.

WriteElementString(String, String, String, String)

지정된 접두사, 로컬 이름, 네임스페이스 URI 및 값을 사용하여 요소를 씁니다.Writes an element with the specified prefix, local name, namespace URI, and value.

WriteElementStringAsync(String, String, String, String)

지정된 접두사, 로컬 이름, 네임스페이스 URI 및 값을 사용하여 요소를 비동기적으로 작성합니다.Asynchronously writes an element with the specified prefix, local name, namespace URI, and value.

WriteEndAttribute()

파생 클래스에서 재정의되면 이전 WriteStartAttribute(String, String) 호출을 닫습니다.When overridden in a derived class, closes the previous WriteStartAttribute(String, String) call.

WriteEndAttributeAsync()

이전 WriteStartAttribute(String, String) 호출을 비동기적으로 닫습니다.Asynchronously closes the previous WriteStartAttribute(String, String) call.

WriteEndDocument()

파생 클래스에서 재정의되면 열려 있는 모든 요소나 특성을 닫고 작성기를 다시 시작 상태로 설정합니다.When overridden in a derived class, closes any open elements or attributes and puts the writer back in the Start state.

WriteEndDocumentAsync()

열려 있는 모든 요소나 특성을 비동기적으로 닫고 작성기를 시작 상태로 설정합니다.Asynchronously closes any open elements or attributes and puts the writer back in the Start state.

WriteEndElement()

파생 클래스에서 재정의되면 한 요소를 닫고 해당 네임스페이스 범위를 팝합니다.When overridden in a derived class, closes one element and pops the corresponding namespace scope.

WriteEndElementAsync()

한 요소를 비동기적으로 닫고 해당 네임스페이스 범위를 팝합니다.Asynchronously closes one element and pops the corresponding namespace scope.

WriteEntityRef(String)

파생 클래스에서 재정의되면 &name; 같이 엔터티 참조를 작성합니다.When overridden in a derived class, writes out an entity reference as &name;.

WriteEntityRefAsync(String)

엔터티 참조를 &name;으로 비동기적으로 작성합니다.Asynchronously writes out an entity reference as &name;.

WriteFullEndElement()

파생 클래스에서 재정의되면 한 요소를 닫고 해당 네임스페이스 범위를 팝합니다.When overridden in a derived class, closes one element and pops the corresponding namespace scope.

WriteFullEndElementAsync()

한 요소를 비동기적으로 닫고 해당 네임스페이스 범위를 팝합니다.Asynchronously closes one element and pops the corresponding namespace scope.

WriteName(String)

파생 클래스에서 재정의되면 W3C XML 1.0 권장 사항(https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name))에 따라 유효한 이름이 되도록 지정된 이름을 작성합니다.When overridden in a derived class, writes out the specified name, ensuring it is a valid name according to the W3C XML 1.0 recommendation (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))에 따라 유효한 이름이 되도록 지정된 이름을 비동기적으로 작성합니다.Asynchronously writes out the specified name, ensuring it is a valid name according to the W3C XML 1.0 recommendation (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이 되도록 지정된 이름을 작성합니다.When overridden in a derived class, writes out the specified name, ensuring it is a valid NmToken according to the W3C XML 1.0 recommendation (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).

WriteNmTokenAsync(String)

W3C XML 1.0 권장 사항(https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name))에 따라 유효한 NmToken이 되도록 지정된 이름을 비동기적으로 작성합니다.Asynchronously writes out the specified name, ensuring it is a valid NmToken according to the W3C XML 1.0 recommendation (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).

WriteNode(XmlReader, Boolean)

파생 클래스에서 재정의되면 판독기에서 작성기로 모든 항목을 복사하고 판독기를 다음 형제 노드의 시작 부분으로 이동합니다.When overridden in a derived class, copies everything from the reader to the writer and moves the reader to the start of the next sibling.

WriteNode(XPathNavigator, Boolean)

XPathNavigator 개체 전체를 작성기에 복사합니다.Copies everything from the XPathNavigator object to the writer. XPathNavigator 위치는 변경되지 않습니다.The position of the XPathNavigator remains unchanged.

WriteNodeAsync(XmlReader, Boolean)

파생 클래스에서 재정의되면 판독기에서 작성기로 모든 항목을 비동기적으로 복사하고 판독기를 다음 형제 노드의 시작 부분으로 이동합니다.Asynchronously copies everything from the reader to the writer and moves the reader to the start of the next sibling.

WriteNodeAsync(XPathNavigator, Boolean)

XPathNavigator 개체의 모든 항목을 작성기에 비동기적으로 복사합니다.Asynchronously copies everything from the XPathNavigator object to the writer. XPathNavigator 위치는 변경되지 않습니다.The position of the XPathNavigator remains unchanged.

WriteProcessingInstruction(String, String)

파생 클래스에서 재정의되면 <?name text?> 같이 이름과 텍스트 사이에 공백이 있는 처리 명령을 작성합니다.When overridden in a derived class, writes out a processing instruction with a space between the name and text as follows: <?name text?>.

WriteProcessingInstructionAsync(String, String)

이름과 텍스트 사이의 공백을 사용하여 처리 명령을 비동기적으로 씁니다(예: <?name text?>).Asynchronously writes out a processing instruction with a space between the name and text as follows: <?name text?>.

WriteQualifiedName(String, String)

파생 클래스에서 재정의되면 네임스페이스로 한정된 이름을 작성합니다.When overridden in a derived class, writes out the namespace-qualified name. 이 메서드는 지정된 네임스페이스의 범위에 속하는 접두사를 찾습니다.This method looks up the prefix that is in scope for the given namespace.

WriteQualifiedNameAsync(String, String)

네임스페이스로 한정된 이름을 비동기적으로 작성합니다.Asynchronously writes out the namespace-qualified name. 이 메서드는 지정된 네임스페이스의 범위에 속하는 접두사를 찾습니다.This method looks up the prefix that is in scope for the given namespace.

WriteRaw(Char[], Int32, Int32)

파생 클래스에서 재정의되면 문자 버퍼에서 원시 태그를 직접 작성합니다.When overridden in a derived class, writes raw markup manually from a character buffer.

WriteRaw(String)

파생 클래스에서 재정의되면 문자열에서 원시 태그를 직접 작성합니다.When overridden in a derived class, writes raw markup manually from a string.

WriteRawAsync(Char[], Int32, Int32)

문자 버퍼에서 직접 원시 태그를 비동기적으로 작성합니다.Asynchronously writes raw markup manually from a character buffer.

WriteRawAsync(String)

문자열에서 직접 원시 태그를 비동기적으로 작성합니다.Asynchronously writes raw markup manually from a string.

WriteStartAttribute(String)

지정된 로컬 이름을 사용하여 특성의 시작 부분을 작성합니다.Writes the start of an attribute with the specified local name.

WriteStartAttribute(String, String)

지정된 로컬 이름과 네임스페이스 URI를 사용하여 특성의 시작 부분을 작성합니다.Writes the start of an attribute with the specified local name and namespace URI.

WriteStartAttribute(String, String, String)

파생 클래스에서 재정의되면 지정된 접두사, 로컬 이름 및 네임스페이스 URI를 사용하여 특성의 시작 부분을 작성합니다.When overridden in a derived class, writes the start of an attribute with the specified prefix, local name, and namespace URI.

WriteStartAttributeAsync(String, String, String)

지정된 접두사, 로컬 이름 및 네임스페이스 URI를 사용하여 특성의 시작 부분을 비동기적으로 작성합니다.Asynchronously writes the start of an attribute with the specified prefix, local name, and namespace URI.

WriteStartDocument()

파생 클래스에서 재정의되면 버전이 "1.0"인 XML 선언을 작성합니다.When overridden in a derived class, writes the XML declaration with the version "1.0".

WriteStartDocument(Boolean)

파생 클래스에서 재정의되면 버전이 "1.0"이고 독립형 특성이 포함된 XML 선언을 작성합니다.When overridden in a derived class, writes the XML declaration with the version "1.0" and the standalone attribute.

WriteStartDocumentAsync()

버전 "1.0"을 사용하여 XML 선언을 비동기적으로 작성합니다.Asynchronously writes the XML declaration with the version "1.0".

WriteStartDocumentAsync(Boolean)

버전 "1.0"과 독립형 특성을 사용하여 XML 선언을 비동기적으로 작성합니다.Asynchronously writes the XML declaration with the version "1.0" and the standalone attribute.

WriteStartElement(String)

파생 클래스에서 재정의되면 지정된 로컬 이름을 사용하여 시작 태그를 작성합니다.When overridden in a derived class, writes out a start tag with the specified local name.

WriteStartElement(String, String)

파생된 클래스에서 재정의되면 지정된 시작 태그를 작성하고 지정된 네임스페이스에 연결합니다.When overridden in a derived class, writes the specified start tag and associates it with the given namespace.

WriteStartElement(String, String, String)

파생 클래스에서 재정의되면 지정된 시작 태그를 작성하고 지정된 네임스페이스 및 접두사에 연결합니다.When overridden in a derived class, writes the specified start tag and associates it with the given namespace and prefix.

WriteStartElementAsync(String, String, String)

지정된 시작 태그를 비동기적으로 작성하고 주어진 네임스페이스 및 접두사와 연결합니다.Asynchronously writes the specified start tag and associates it with the given namespace and prefix.

WriteString(String)

파생 클래스에서 재정의되면 지정된 텍스트 콘텐츠를 작성합니다.When overridden in a derived class, writes the given text content.

WriteStringAsync(String)

주어진 텍스트 콘텐츠를 비동기적으로 작성합니다.Asynchronously writes the given text content.

WriteSurrogateCharEntity(Char, Char)

파생 클래스에서 재정의되면 서로게이트 문자 쌍에 대한 서로게이트 문자 엔터티를 생성하고 작성합니다.When overridden in a derived class, generates and writes the surrogate character entity for the surrogate character pair.

WriteSurrogateCharEntityAsync(Char, Char)

서로게이트 문자 쌍에 대한 서로게이트 문자 엔터티를 비동기적으로 생성하고 작성합니다.Asynchronously generates and writes the surrogate character entity for the surrogate character pair.

WriteValue(Boolean)

Boolean 값을 작성합니다.Writes a Boolean value.

WriteValue(DateTime)

DateTime 값을 작성합니다.Writes a DateTime value.

WriteValue(DateTimeOffset)

DateTimeOffset 값을 작성합니다.Writes a DateTimeOffset value.

WriteValue(Decimal)

Decimal 값을 작성합니다.Writes a Decimal value.

WriteValue(Double)

Double 값을 작성합니다.Writes a Double value.

WriteValue(Int32)

Int32 값을 작성합니다.Writes a Int32 value.

WriteValue(Int64)

Int64 값을 작성합니다.Writes a Int64 value.

WriteValue(Object)

개체 값을 씁니다.Writes the object value.

WriteValue(Single)

단정밀도 부동 소수점 숫자를 씁니다.Writes a single-precision floating-point number.

WriteValue(String)

String 값을 작성합니다.Writes a String value.

WriteWhitespace(String)

파생 클래스에서 재정의되면 지정된 공백을 작성합니다.When overridden in a derived class, writes out the given white space.

WriteWhitespaceAsync(String)

주어진 공백을 비동기적으로 작성합니다.Asynchronously writes out the given white space.

명시적 인터페이스 구현

IDisposable.Dispose()

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

확장 메서드

ConfigureAwait(IAsyncDisposable, Boolean)

비동기 일회용에서 반환되는 작업을 대기하는 방법을 구성합니다.Configures how awaits on the tasks returned from an async disposable are performed.

적용 대상

추가 정보