XmlWriterSettings.ConformanceLevel Egenskap

public:
 property System::Xml::ConformanceLevel ConformanceLevel { System::Xml::ConformanceLevel get(); void set(System::Xml::ConformanceLevel value); };

public System.Xml.ConformanceLevel ConformanceLevel { get; set; }

member this.ConformanceLevel : System.Xml.ConformanceLevel with get, set

Public Property ConformanceLevel As ConformanceLevel

Egenskapsvärde

Ett av uppräkningsvärdena som anger överensstämmelsenivån (dokument, fragment eller automatisk identifiering). Standardvärdet är Document.

Exempel

I följande exempel skrivs ett XML-fragment till en minnesström.

XmlWriterSettings settings = new XmlWriterSettings();
settings.OmitXmlDeclaration = true;
settings.ConformanceLevel = ConformanceLevel.Fragment;
settings.CloseOutput = false;

// Create the XmlWriter object and write some content.
MemoryStream strm = new MemoryStream();
XmlWriter writer = XmlWriter.Create(strm, settings);
writer.WriteElementString("orderID", "1-456-ab");
writer.WriteElementString("orderID", "2-36-00a");
writer.Flush();
writer.Close();

// Do additional processing on the stream.

Dim settings As XmlWriterSettings = New XmlWriterSettings()
settings.OmitXmlDeclaration = true
settings.ConformanceLevel = ConformanceLevel.Fragment
settings.CloseOutput = false

' Create the XmlWriter object and write some content.
Dim strm as MemoryStream = new MemoryStream()
Dim writer As XmlWriter = XmlWriter.Create(strm, settings)
writer.WriteElementString("orderID", "1-456-ab")
writer.WriteElementString("orderID", "2-36-00a")
writer.Flush()
writer.Close()

' Do additional processing on the stream.

Kommentarer

Egenskapen XmlWriterSettings.ConformanceLevel konfigurerar XML-skrivaren för att kontrollera och garantera att strömmen som skrivs följer en viss uppsättning regler. XML-data kan kontrolleras för att se att de överensstämmer med reglerna för ett välformat XML 1.0-dokument eller ett dokumentfragment. I följande tabell beskrivs de tre inställningarna. Standardvärdet är överensstämmelse på dokumentnivå.

Om XML-skrivaren identifierar information som skulle strida mot den angivna överensstämmelsenivån utlöser den ett undantag. I vissa fall korrigerar XML-skrivaren automatiskt kompatibilitetsfelet. Skrivaren stänger till exempel ett oskärmat attribut utan att utlösa ett undantag. I följande tabell visas hur olika efterlevnadsöverträdelser hanteras i varje inställning.