ConformanceLevel ConformanceLevel ConformanceLevel ConformanceLevel Enum

Definition

Gibt den Umfang der Eingabe- oder Ausgabeüberprüfung an, die von dem XmlReader-Objekt und dem XmlWriter-Objekt ausgeführt wird.Specifies the amount of input or output checking that XmlReader and XmlWriter objects perform.

public enum class ConformanceLevel
public enum ConformanceLevel
type ConformanceLevel = 
Public Enum ConformanceLevel
Vererbung
ConformanceLevelConformanceLevelConformanceLevelConformanceLevel

Felder

Auto Auto Auto Auto 0

Das XmlReader-Objekt oder das XmlWriter-Objekt erkennen automatisch, ob eine Dokumentebenen- oder Fragmentebenenprüfung ausgeführt werden soll, und nehmen die entsprechende Prüfung vor.The XmlReader or XmlWriter object automatically detects whether document-level or fragment-level checking should be performed, and does the appropriate checking. Wenn Sie ein weiteres XmlReader- oder XmlWriter-Objekt umschließen, wird für das äußere Objekt keine zusätzliche Übereinstimmungsprüfung vorgenommen.If you're wrapping another XmlReader or XmlWriter object, the outer object doesn't do any additional conformance checking. Die Übereinstimmungsprüfung wird dem zugrunde liegenden Objekt überlassen.Conformance checking is left up to the underlying object.

Weitere Details dahingehend, wie die Übereinstimmungsprüfung festgelegt wird, finden Sie unter den ConformanceLevel- und den ConformanceLevel-Eigenschaften.See the ConformanceLevel and ConformanceLevel properties for details on how the compliance level is determined.

Document Document Document Document 2

Die XML-Daten entsprechen den Regeln für ein wohlgeformtes XML 1.0-Dokument gemäß W3C-Definition.The XML data complies with the rules for a well-formed XML 1.0 document, as defined by the W3C. Diese Ebene der Überprüfung sorgt dafür, dass alle Prozessoren den gelesenen oder geschriebenen Stream als XML 1.0-Dokument verwenden können.This level of checking ensures that the stream being read or written can be consumed by any processor as an XML 1.0 document.

Fragment Fragment Fragment Fragment 1

Die XML-Daten entsprechen den Regeln für ein wohlgeformtes XML-Fragment gemäß W3C-Definition.The XML data is a well-formed XML fragment, as defined by the W3C. Dieser Konformitätsgrad steht für ein XML-Dokument, das möglicherweise kein Stammelement aufweist, aber ansonsten wohlgeformt ist.This conformance level represents an XML document that might not have a root element but is otherwise well-formed. Diese Ebene der Überprüfung sorgt dafür, dass alle Prozessoren den gelesenen oder geschriebenen Stream als extern analysierte XML 1.0-Entität verwenden können.This level of checking ensures that the stream being read or written can be consumed by any processor as an XML 1.0 external parsed entity].

Hinweise

Wenn Sie einen XML-Reader oder eine Writer-Instanz erstellen, können XmlReaderSettings Sie XmlWriterSettings die-Klasse oder die-Klasse verwenden, um die Funktionen anzugeben, die von der neuen Instanz unterstützt werden sollen.When you create an XML reader or writer instance, you can use the XmlReaderSettings or XmlWriterSettings class to specify the features that you want the new instance to support. Eine der Funktionen, die Sie konfigurieren können, ist die Ebene der Übereinstimmung, die Sie für die XML-Daten erzwingen möchten.One of the features that you can configure is the level of conformance you want to enforce on the XML data.

Wenn Sie einen kompatiblen Reader oder Writer erstellen, wird sichergestellt, dass die verarbeiteten XML-Daten mit dem angegebenen Konformitäts Grad übereinstimmen.Creating a compliant reader or writer guarantees that the XML data being processed complies with the specified conformance level. Wenn der gelesene oder geschriebene Stream nicht mit der Konformitäts Ebene übereinstimmt, wird eine Ausnahme ausgelöst.If the stream being read or written doesn't comply with the conformance level, an exception is thrown.

Überprüfungen auf Dokument Ebene mit ConformanceLevel.Document dem-Enumerationsmember erzwingen Überprüfungen auf ConformanceLevel.Fragment Fragmentebene (das-Element) und stellen außerdem Folgendes sicher:Document-level checks with the ConformanceLevel.Document enumeration member enforce fragment-level checks (the ConformanceLevel.Fragment member) and also ensure the following:

  • Das Element der obersten Ebene hat keine anderen Knoten als die XML-Deklaration, DTD, Element, Kommentar, Leerraum oder Verarbeitungsanweisung.The top-level item doesn't have any nodes other than the XML declaration, DTD, element, comment, white space, or processing instruction.

  • Die XML-Daten verfügen nur über einen und nur einen Elementknoten der obersten Ebene.The XML data has one and only one top-level element node.

Gilt für:

Siehe auch