XmlWriter.WriteStartDocument Yöntem

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kod:

System.Xml.ReaderWriter.dll

Bütünleştirilmiş Kod:

System.Xml.dll

Bütünleştirilmiş Kod:

netstandard.dll

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

Aşırı Yüklemeler

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)

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, yazarın nasıl uygulandığına göre belirlenir. Örneğin, oluşturucuda XmlTextWriter bir Encoding 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 WriteProcessingInstruction başka bir XML bildirimi oluşturmak için kullanılırsaWriteStartDocument, bir özel durum oluşturulur.

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

WriteStartDocument()

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, yazarın nasıl uygulandığına göre belirlenir. Örneğin, oluşturucuda XmlTextWriter bir Encoding nesne belirtilirse, kodlama özniteliğinin değerini belirler. Bu yöntem tek başına bir öznitelik oluşturmaz.

WriteStartDocument çağrıldığında, 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 kuralı uygulamaz.

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

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