XmlWriterSettings Sınıf

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

yöntemi tarafından Create oluşturulan nesnede XmlWriter destek için bir özellik kümesi 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, bir XmlWriter XML 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ışı üretir:

<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.

Not

yöntemini kullanarak nesnesini kullanıyorsanızXmlWriter, doğru ayarlara sahip bir XmlWriterSettings nesne almak için özelliğini kullanmanız OutputSettingsTransform gerekir. 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:

Özellik	Belirler	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	Çıkışı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üzeyinde uyumluluk)
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:

Özellik	Belirler	Değer	Varsayılan
Encoding	Kullanılacak metin kodlaması.	System.Text.Encoding Değer	Encoding.UTF8
Indent	Öğelerin girintilenip girintilenmeyeceği	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 (satır başı, 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	Özniteliklerin tek tek satırlara yazıp yazılmayacağı (olduğunda Indentfalsehiçbir etkisi yoktur).	true veya false	false
OmitXmlDeclaration	XML bildirimi yazıp yazılmayacağı.	true veya false	false

Oluşturucular

XmlWriterSettings()

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

Özellikler

Async	Belirli XmlWriter bir örnekte zaman uyumsuz yöntemlerin XmlWriter kullanılıp kullanılamayacağını belirten 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ı denetleyişinin 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	Öğelerin girintilenip girintilenmeyeceğini belirten bir değer alır veya ayarlar.
IndentChars	Girintileme sırasında kullanılacak karakter dizesini alır veya ayarlar. Özellik olarak ayarlandığında truebu ayar kullanılırIndent.
NamespaceHandling	XML içeriği yazarken yinelenen ad alanı bildirimlerini kaldırması gerekip gerekmediğini XmlWriter belirten bir değer alır veya ayarlar. Varsayılan davranış, yazıcının, yazarın ad alanı çözümleyicisinde bulunan tüm ad alanı bildirimlerini çıkışına 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ştirılmeyeceğ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() öğesinin kapatılmamış tüm öğe etiketlerine kapanış etiketleri ekleyip eklemeyeceğini XmlWriter belirten bir değer alır veya ayarlar.

Yöntemler

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()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectöğesinin sığ 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 dizeyi döndürür. (Devralındığı yer: Object)