다음을 통해 공유


XmlWriter.WriteStartDocument 메서드

정의

파생 클래스에서 재정의되면 XML 선언을 작성합니다.

오버로드

WriteStartDocument(Boolean)

파생 클래스에서 재정의되면 버전이 "1.0"이고 독립형 특성이 포함된 XML 선언을 작성합니다.

WriteStartDocument()

파생 클래스에서 재정의되면 버전이 "1.0"인 XML 선언을 작성합니다.

설명

이 메서드의 비동기 버전은 다음을 참조하세요 WriteStartDocumentAsync.

WriteStartDocument(Boolean)

파생 클래스에서 재정의되면 버전이 "1.0"이고 독립형 특성이 포함된 XML 선언을 작성합니다.

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

true이면 "standalone=yes"로 작성하고, false이면 "standalone=no"로 작성합니다.

예외

생성자 다음에 호출된 첫 번째 쓰기 메서드가 아닌 경우

또는

이전 비동기 작업이 완료되기 전에 XmlWriter 메서드가 호출되었습니다. 이 경우 “비동기 작업이 이미 진행 중입니다.” 메시지를 나타내며 InvalidOperationException이 throw됩니다.

설명

문서의 인코딩 수준은 작성기가 구현되는 방식에 따라 결정됩니다. 예를 들어 개체가 Encoding 생성자에 지정된 XmlTextWriter 경우 인코딩 특성의 값이 결정됩니다.

WriteStartDocument 호출되면 작성자는 작성하는 내용이 올바른 형식의 XML 문서인지 확인합니다. 예를 들어 XML 선언이 첫 번째 노드이고 루트 수준 요소가 하나만 있는지 확인합니다. 이 메서드가 호출되지 않으면 작성기는 XML 조각이 작성되고 있다고 가정하고 루트 수준 규칙을 적용하지 않습니다.

호출된 다음 메서드를 WriteProcessingInstruction 사용하여 다른 XML 선언을 만들면 WriteStartDocument 예외가 throw됩니다.

이 메서드의 비동기 버전은 다음을 참조하세요 WriteStartDocumentAsync.

적용 대상

WriteStartDocument()

파생 클래스에서 재정의되면 버전이 "1.0"인 XML 선언을 작성합니다.

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

예외

생성자 다음에 호출된 첫 번째 쓰기 메서드가 아닌 경우

또는

이전 비동기 작업이 완료되기 전에 XmlWriter 메서드가 호출되었습니다. 이 경우 “비동기 작업이 이미 진행 중입니다.” 메시지를 나타내며 InvalidOperationException이 throw됩니다.

설명

문서의 인코딩 수준은 작성기 구현 방법에 따라 결정됩니다. 예를 들어 생성자에 개체를 XmlTextWriter 지정하면 Encoding 인코딩 특성의 값이 결정됩니다. 이 메서드는 독립 실행형 특성을 만들지 않습니다.

WriteStartDocument 기록기라고 하면 작성자가 작성하는 내용이 올바른 형식의 XML 문서인지 확인합니다. 예를 들어 XML 선언이 첫 번째 노드인지, 루트 수준 요소 하나만 존재하는지 확인합니다. 이 메서드가 호출되지 않으면 작성기는 XML 조각이 작성되고 있다고 가정하고 루트 수준 규칙을 적용하지 않습니다.

호출된 다음 메서드를 WriteProcessingInstruction 사용하여 다른 XML 선언을 만들면 WriteStartDocument 예외가 throw됩니다.

이 메서드의 비동기 버전은 다음을 참조하세요 WriteStartDocumentAsync.

적용 대상