XmlWriterSettings Sınıf

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Xml.ReaderWriter.dll

Kaynak:

XmlWriterSettings.cs

yöntemi tarafından XmlWriter oluşturulan nesnede Create destek eklenecek bir özellik kümesini belirtir.

public ref class XmlWriterSettings sealed

public sealed class XmlWriterSettings

type XmlWriterSettings = class

Public NotInheritable Class XmlWriterSettings

Devralma

Object

XmlWriterSettings

Örnekler

Aşağıdaki örnek, XML XmlWriter dosyasına yazan ve her özniteliği yeni bir satıra yazan bir oluşturur.

XmlWriterSettings settings = new XmlWriterSettings();
settings.Indent = true;
settings.OmitXmlDeclaration = true;
settings.NewLineOnAttributes = true;

writer = XmlWriter.Create(Console.Out, settings);

writer.WriteStartElement("order");
writer.WriteAttributeString("orderID", "367A54");
writer.WriteAttributeString("date", "2001-05-03");
writer.WriteElementString("price", "19.95");
writer.WriteEndElement();
    
writer.Flush();

        Dim settings As New XmlWriterSettings()
        settings.Indent = True
        settings.OmitXmlDeclaration = True
        settings.NewLineOnAttributes = True
   
        writer = XmlWriter.Create(Console.Out, settings)

        writer.WriteStartElement("order")
        writer.WriteAttributeString("orderID", "367A54")
        writer.WriteAttributeString("date", "2001-05-03")
        writer.WriteElementString("price", "19.95")
        writer.WriteEndElement()

        writer.Flush()

Örnek aşağıdaki çıkışı oluşturur:

<order
  orderID="367A54"
  date="2001-05-03">
  <price>19.95</price>
</order>

Açıklamalar

Create yöntemi, örnekleri almak XmlWriter için tercih edilen mekanizmadır. yöntemi, Create oluşturulan nesnede XmlWriterSettings hangi özelliklerin uygulanacağını belirtmek için sınıfını XmlWriter kullanır.

Uyarı

yöntemini kullanarak nesnesini kullanıyorsanızXmlWriter, doğru ayarlara sahip bir XmlWriterSettings nesne almak için özelliğini kullanmanız OutputSettings gerekir.Transform Bu, oluşturulan XmlWriter nesnenin doğru çıkış ayarlarına sahip olmasını sağlar.

sınıfı, XmlWriterSettings veri uyumluluğu ve çıkış biçimini denetleyan özellikler sağlar.

Veri uyumluluğu denetimleri ve otomatik düzeltmeler için şu özellikleri kullanın:

Mülkiyet	Belirtir	Değer	Varsayılan
CheckCharacters	W3C tarafından tanımlandığı gibi, karakterlerin yasal XML karakter kümesinde olup olmadığının denetlenip denetlenmeyeceği.	true veya false	true
ConformanceLevel	Çıktının iyi biçimlendirilmiş bir XML 1.0 belgesi veya parçası olup olmadığını denetleme.	ConformanceLevel.Document (belge düzeyi), Fragment (parça düzeyi) veya Auto (otomatik algılama)	ConformanceLevel.Document (belge düzeyi uyumluluğu)
WriteEndDocumentOnClose	Yöntem çağrıldığında kapatılmamış tüm öğelere kapanış etiketleri eklenip eklenmeyeceği Close .	true veya false	true

Çıkış biçimini belirtmek için şu özellikleri kullanın:

Mülkiyet	Belirtir	Değer	Varsayılan
Encoding	Kullanılacak metin kodlaması.	System.Text.Encoding değer	Encoding.UTF8
Indent	Öğeleri girintileyip girintilemeyeceğiniz	true veya false	false (girinti yok)
IndentChars	Girintileme sırasında kullanılacak karakter dizesi (olarak ayarlandığında truekullanılırIndent).	Dize	İki boşluk
NewLineChars	Satır sonları için kullanılacak karakter dizesi.	Dize	\r\n Unix dışı platformlar için (satır başı, satır besleme) veya \n Unix platformları için (satır besleme)
NewLineHandling	Yeni satır karakterlerini işleme.	System.Xml.NewLineHandling value: Entitize (normalize), Replace (replace) veya None (değişmeden bırakın)	Replace (tarafından belirtilen NewLineCharskarakterlerle değiştirin)
NewLineOnAttributes	Tek tek satırlara öznitelik yazıp yazılmayacağı (olduğunda falsehiçbir etkisi Indent yoktur).	true veya false	false
OmitXmlDeclaration	XML bildirimi yazıp yazılmayacağı.	true veya false	false

Oluşturucular

Name	Description
XmlWriterSettings()	XmlWriterSettings sınıfının yeni bir örneğini başlatır.

Özellikler

Name	Description
Async	Belirli XmlWriter bir örnekte zaman uyumsuz yöntemlerin XmlWriter kullanılıp kullanılamayacağını gösteren bir değer alır veya ayarlar.
CheckCharacters	BELGEdeki tüm karakterlerin W3C XML 1.0 Önerisi'nin "2.2 Karakter" bölümüne uygun olduğundan emin olmak için XML yazıcısının denetlemesi gerekip gerekmediğini belirten bir değer alır veya ayarlar.
CloseOutput	öğesinin XmlWriter de temel alınan akışı kapatması gerektiğini veya yöntemin Close() ne zaman çağrıldığını belirten bir değer alır veya TextWriter ayarlar.
ConformanceLevel	XML yazıcısının XML çıkışını denetlediğini uyumluluk düzeyini alır veya ayarlar.
DoNotEscapeUriAttributes	URI özniteliklerinden kaçmadığını XmlWriter belirten bir değer alır veya ayarlar.
Encoding	Kullanılacak metin kodlama türünü alır veya ayarlar.
Indent	Öğeleri girintileyip girintilemeyeceğini belirten bir değer alır veya ayarlar.
IndentChars	Girintileme sırasında kullanılacak karakter dizesini alır veya ayarlar. Bu ayar özelliği olarak ayarlandığında truekullanılırIndent.
NamespaceHandling	XML içeriği yazarken yinelenen ad alanı bildirimlerini kaldırması XmlWriter gerekip gerekmediğini belirten bir değer alır veya ayarlar. Varsayılan davranış, yazıcının ad alanı çözümleyicisinde bulunan tüm ad alanı bildirimlerini çıktı olarak vermesine yöneliktir.
NewLineChars	Satır sonları için kullanılacak karakter dizesini alır veya ayarlar.
NewLineHandling	Çıktıdaki satır sonlarının normalleştirilip normalleştirmeyeceğini belirten bir değer alır veya ayarlar.
NewLineOnAttributes	Özniteliklerin yeni bir satıra yazılıp yazılmayacağını belirten bir değer alır veya ayarlar.
OmitXmlDeclaration	XML bildiriminin atlanıp atlanmayacağını belirten bir değer alır veya ayarlar.
OutputMethod	Çıkışı serileştirmek XmlWriter için kullanılan yöntemini alır.
WriteEndDocumentOnClose	yöntemi çağrıldığında Close() kapatılmamış tüm öğe etiketlerine kapanış etiketleri ekleyip eklemeyeceğini XmlWriter belirten bir değer alır veya ayarlar.

Yöntemler

Name	Description
Clone()	Örneğin bir kopyasını XmlWriterSettings oluşturur.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
Reset()	Ayarlar sınıfının üyelerini varsayılan değerlerine sıfırlar.
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)