XmlWriterSettings.ConformanceLevel Eigenschaft

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

Eigenschaftswert

Einer der Enumerationswerte, der das Übereinstimmungsniveau angibt (Dokument, Fragment oder automatische Erkennung). Der Standardwert ist Document.

Beispiele

Im folgenden Beispiel wird ein XML-Fragment in einen Speicherdatenstrom geschrieben.

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.

Hinweise

Die XmlWriterSettings.ConformanceLevel -Eigenschaft konfiguriert den XML-Writer, um zu überprüfen und sicherzustellen, dass der zu schreibende Stream einem bestimmten Satz von Regeln entspricht. Die XML-Daten können überprüft werden, um festzustellen, dass sie den Regeln für ein wohlgeformtes XML 1.0-Dokument oder ein Dokumentfragment entsprechen. In der folgenden Tabelle werden die drei Einstellungen beschrieben. Der Standardwert ist Konformität auf Dokumentebene.

Wenn der XML-Writer Informationen erkennt, die gegen die angegebene Konformitätsstufe verstoßen würden, löst er eine Ausnahme aus. In einigen Fällen korrigiert der XML-Writer den Konformitätsfehler automatisch. Beispielsweise schließt der Writer ein nicht geschlossenes Attribut, ohne eine Ausnahme zu auslösen. Die folgende Tabelle zeigt, wie verschiedene Konformitätsverletzungen in jeder Einstellung behandelt werden.

Gilt für: