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 abstract class XmlWriter : IDisposable
type XmlWriter = class
    interface IDisposable
Public MustInherit Class XmlWriter
Implements IDisposable
상속
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 지원 Extensible Markup Language (XML) 1.0 (1.0(fourth edition) 하 고 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.

  • 이진 바이트를 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 작성기에서 사용 하도록 설정 하려는 기능의 집합을 지정 하려면를 XmlWriterSettingsCreate 메서드.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. 이 속성을 사용하는 경우 Indenttrue로 설정해야 합니다.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 속성에는 XML 작성기입니다. 문자를 확인 하 고 throw 하도록 지시를 XmlException 문자가 W3C에서 정의 된 대로 올바른 범위를 벗어나는 경우 예외입니다.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.

    수준Level 설명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 작성기 conformation 적용할 검사 (문서 또는 조각) 들어오는 데이터를 기반으로 수준을 결정 합니다.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. Namespace 접두사에 대 한 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) 개체를 수락, 입력된 값은 XML 스키마 정의 언어 (XSD) 데이터 형식 변환 규칙에 따라 해당 문자열 표현으로 변환 및 사용 하 여 작성 된 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.

형식화 된 값을 텍스트에 쓸 때 사용 하 여 텍스트도 serialize 되는 XmlConvert 해당 스키마 형식에 대 한 규칙입니다.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 됩니다. 데이터 저장소를 사용 가능한 스키마 정보가 없으면 합니다 WriteValue 메서드는 모든 값으로 처리는 xsd:anySimpleType 형식입니다.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.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

사용 하는 경우 XmlWriter XML 요소 및 특성을 출력 하는 메서드를 호출 하기 전에 기록 되지 않습니다는 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. 예를 들어, 비동기 WriteAttributeStringWriteAttributeStringAsync합니다.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.

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().

적용 대상

추가 정보