XmlWriter.WriteStartDocument Yöntem

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Xml.ReaderWriter.dll

Türetilmiş bir sınıfta geçersiz kılındığında XML bildirimini yazar.

Aşırı Yüklemeler

Name	Description
WriteStartDocument(Boolean)	Türetilmiş bir sınıfta geçersiz kılındığında, XML bildirimini "1.0" sürümü ve tek başına özniteliğiyle yazar.
WriteStartDocument()	Türetilmiş bir sınıfta geçersiz kılındığında, XML bildirimini "1.0" sürümüyle yazar.

Açıklamalar

Bu yöntemin zaman uyumsuz sürümü için bkz WriteStartDocumentAsync. .

WriteStartDocument(Boolean)

Kaynak:

XmlWriter.cs

Türetilmiş bir sınıfta geçersiz kılındığında, XML bildirimini "1.0" sürümü ve tek başına özniteliğiyle yazar.

public:
 abstract void WriteStartDocument(bool standalone);

public abstract void WriteStartDocument(bool standalone);

abstract member WriteStartDocument : bool -> unit

Public MustOverride Sub WriteStartDocument (standalone As Boolean)

Parametreler

standalone

Boolean

ise true"standalone=yes" yazar; ise false"standalone=no" yazar.

Özel durumlar

InvalidOperationException

Bu oluşturucudan sonra çağrılan ilk yazma yöntemi değildir.

-veya-

Önceki XmlWriter bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.

Açıklamalar

Belgenin kodlama düzeyi, yazıcının nasıl uygulandığına göre belirlenir. Örneğin, oluşturucuda Encoding bir XmlTextWriter nesne belirtilirse bu, kodlama özniteliğinin değerini belirler.

Çağrıldığında WriteStartDocument , yazıcı yazdığınız şeyin iyi biçimlendirilmiş bir XML belgesi olduğunu doğrular. Örneğin, XML bildiriminin ilk düğüm olduğunu, bir ve yalnızca bir kök düzeyi öğesinin mevcut olduğunu vb. denetler. Bu yöntem çağrılmazsa, yazıcı bir XML parçasının yazıldığını varsayar ve kök düzeyi kuralları uygulamaz.

Çağrılırsa ve yöntemi WriteStartDocument başka bir XML bildirimi oluşturmak için kullanılırsaWriteProcessingInstruction, bir özel durum oluşturulur.

Bu yöntemin zaman uyumsuz sürümü için bkz WriteStartDocumentAsync. .

WriteStartDocument()

Kaynak:

XmlWriter.cs

Türetilmiş bir sınıfta geçersiz kılındığında, XML bildirimini "1.0" sürümüyle yazar.

public:
 abstract void WriteStartDocument();

public abstract void WriteStartDocument();

abstract member WriteStartDocument : unit -> unit

Public MustOverride Sub WriteStartDocument ()

Özel durumlar

InvalidOperationException

Bu oluşturucudan sonra çağrılan ilk yazma yöntemi değildir.

-veya-

Önceki XmlWriter bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.

Açıklamalar

Belgenin kodlama düzeyi, yazıcının nasıl uygulandığına göre belirlenir. Örneğin, oluşturucuda Encoding bir XmlTextWriter nesne belirtilirse bu, kodlama özniteliğinin değerini belirler. Bu yöntem tek başına bir öznitelik oluşturmaz.

Ne zaman WriteStartDocument çağrılırsa, yazıcı yazdığınız şeyin iyi biçimlendirilmiş bir XML belgesi olduğunu doğrular. Örneğin, XML bildiriminin ilk düğüm olduğunu, bir ve yalnızca bir kök düzeyi öğesinin mevcut olduğunu vb. denetler. Bu yöntem çağrılmazsa, yazıcı bir XML parçasının yazıldığını varsayar ve kök düzeyi kuralları uygulamaz.

Çağrılırsa ve yöntemi WriteStartDocument başka bir XML bildirimi oluşturmak için kullanılırsaWriteProcessingInstruction, bir özel durum oluşturulur.

Bu yöntemin zaman uyumsuz sürümü için bkz WriteStartDocumentAsync. .