Aracılığıyla paylaş


XmlWriterSettings Sınıf

Tanım

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

Şunlara uygulanır