XmlWriter.WriteStartDocument Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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 -> unitPublic MustOverride Sub WriteStartDocument (standalone As Boolean)Parametreler
- standalone
- Boolean
ise true"standalone=yes" yazar; ise false"standalone=no" yazar.
Özel durumlar
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. .
Şunlara uygulanır
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 -> unitPublic MustOverride Sub WriteStartDocument ()Özel durumlar
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. .