XmlWriter.WriteStartDocument XmlWriter.WriteStartDocument XmlWriter.WriteStartDocument XmlWriter.WriteStartDocument Method

정의

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

오버로드

WriteStartDocument() WriteStartDocument() WriteStartDocument() WriteStartDocument()

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

WriteStartDocument(Boolean) WriteStartDocument(Boolean) WriteStartDocument(Boolean) 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합니다.For the asynchronous version of this method, see WriteStartDocumentAsync.

WriteStartDocument() WriteStartDocument() WriteStartDocument() WriteStartDocument()

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

public:
 abstract void WriteStartDocument();
public abstract void WriteStartDocument ();
abstract member WriteStartDocument : unit -> unit
Public MustOverride Sub WriteStartDocument ()

예외

생성자 다음에 호출된 첫 번째 쓰기 메서드가 아닌 경우This is not the first write method called after the constructor.

또는-or-

이전 비동기 작업이 완료되기 전에 XmlWriter 메서드가 호출되었습니다.An XmlWriter method was called before a previous asynchronous operation finished. 이 경우 “비동기 작업이 이미 진행 중입니다.” 메시지를 나타내며 InvalidOperationException이 throw됩니다.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

설명

문서의 인코딩 수준은 작성기 구현 방법으로 결정 됩니다.The encoding level of the document is determined by how the writer is implemented. 예를 들어 경우는 Encoding 개체에 지정 된는 XmlTextWriter 생성자가 인코딩 특성의 값을 결정 합니다.For example, if an Encoding object is specified in the XmlTextWriter constructor, this determines the value of the encoding attribute. 이 메서드는 독립 실행형 특성을 만들지 않습니다.This method does not create a standalone attribute.

WriteStartDocument 라고 기록기를 작성 하는 올바른 형식의 XML 문서 인지 확인 합니다.When WriteStartDocument is called the writer validates that what you are writing is a well-formed XML document. 예를 들어, XML 선언이 첫 번째 노드 하나 및 루트 수준 요소가 하나만 있고 등 확인 합니다.For example, it checks that the XML declaration is the first node, that one and only one root-level element exists, and so on. 이 메서드를 호출 하지 않으면 경우 작성기 가정 XML 조각을 쓰고 없습니다 루트 수준 규칙을 적용 합니다.If this method is not called, the writer assumes an XML fragment is being written and applies no root level rules.

하는 경우 WriteStartDocument 를 호출한 다음는 WriteProcessingInstruction 메서드는 다른 XML 선언을 만드는 데, 예외가 throw 됩니다.If WriteStartDocument has been called and then the WriteProcessingInstruction method is used to create another XML declaration, an exception will be thrown.

이 메서드의 비동기 버전을 참조 하세요. WriteStartDocumentAsync합니다.For the asynchronous version of this method, see WriteStartDocumentAsync.

WriteStartDocument(Boolean) WriteStartDocument(Boolean) WriteStartDocument(Boolean) WriteStartDocument(Boolean)

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

public:
 abstract void WriteStartDocument(bool standalone);
public abstract void WriteStartDocument (bool standalone);
abstract member WriteStartDocument : bool -> unit
Public MustOverride Sub WriteStartDocument (standalone As Boolean)

매개 변수

standalone
Boolean Boolean Boolean Boolean

true이면 "standalone=yes"로 작성하고, false이면 "standalone=no"로 작성합니다.If true, it writes "standalone=yes"; if false, it writes "standalone=no".

예외

생성자 다음에 호출된 첫 번째 쓰기 메서드가 아닌 경우This is not the first write method called after the constructor.

또는-or-

이전 비동기 작업이 완료되기 전에 XmlWriter 메서드가 호출되었습니다.An XmlWriter method was called before a previous asynchronous operation finished. 이 경우 “비동기 작업이 이미 진행 중입니다.” 메시지를 나타내며 InvalidOperationException이 throw됩니다.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

설명

문서의 인코딩 수준은 작성기 구현 방법으로 결정 됩니다.The encoding level of the document is determined by how the writer is implemented. 예를 들어 경우는 Encoding 개체에 지정 된는 XmlTextWriter 생성자가 인코딩 특성의 값을 결정 합니다.For example, if an Encoding object is specified in the XmlTextWriter constructor, this determines the value of the encoding attribute.

WriteStartDocument 는 호출 작성기의 유효성을 검사 작성 하는 올바른 형식의 XML 문서입니다.When WriteStartDocument is called, the writer validates that what you are writing is a well-formed XML document. 예를 들어, XML 선언이 첫 번째 노드 하나 및 루트 수준 요소가 하나만 있고 등 확인 합니다.For example, it checks that the XML declaration is the first node, that one and only one root-level element exists, and so on. 이 메서드를 호출 하지 않으면 경우 작성기 가정 XML 조각을 쓰고 없습니다 루트 수준 규칙을 적용 합니다.If this method is not called, the writer assumes an XML fragment is being written and applies no root level rules.

하는 경우 WriteStartDocument 를 호출한 다음는 WriteProcessingInstruction 메서드는 다른 XML 선언을 만드는 데, 예외가 throw 됩니다.If WriteStartDocument has been called and then the WriteProcessingInstruction method is used to create another XML declaration, an exception will be thrown.

이 메서드의 비동기 버전을 참조 하세요. WriteStartDocumentAsync합니다.For the asynchronous version of this method, see WriteStartDocumentAsync.

적용 대상