ConformanceLevel Výčet

Definice

Určuje množství kontroly vstupu a výstupu, které XmlReader XmlWriter provádí objekty.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
Dědičnost
ConformanceLevel

Pole

Auto 0

XmlReaderObjekt nebo XmlWriter automaticky zjišťuje, zda by měla být provedena kontrola na úrovni dokumentu nebo fragmentu, a provede příslušnou kontrolu.The XmlReader or XmlWriter object automatically detects whether document-level or fragment-level checking should be performed, and does the appropriate checking. Pokud zabalíte jiný XmlReader XmlWriter objekt nebo, vnější objekt neprovádí žádnou další kontrolu shody.If you're wrapping another XmlReader or XmlWriter object, the outer object doesn't do any additional conformance checking. Kontrola shody je ponechána na podkladovém objektu.Conformance checking is left up to the underlying object.

ConformanceLevel ConformanceLevel Podrobnosti o tom, jak se určuje úroveň dodržování předpisů, najdete v tématu vlastnosti a.See the ConformanceLevel and ConformanceLevel properties for details on how the compliance level is determined.

Document 2

Data XML jsou v souladu s pravidly pro dobře vytvořený dokument xml 1,0, jak je definováno konsorciem W3C.The XML data complies with the rules for a well-formed XML 1.0 document, as defined by the W3C. Tato úroveň kontroly zajišťuje, že datový proud, který se čte nebo zapisuje, může být využíván jakýmkoli procesorem jako dokument XML 1,0.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 1

Data XML jsou ve správném formátu fragment XML, jak je definováno konsorciem W3C.The XML data is a well-formed XML fragment, as defined by the W3C. Tato úroveň shody představuje dokument XML, který by neměl mít kořenový element, ale je jinak ve správném formátu.This conformance level represents an XML document that might not have a root element but is otherwise well-formed. Tato úroveň kontroly zajišťuje, že datový proud, který se čte nebo zapisuje, může být využíván jakýmkoli procesorem jako externí analyzovanou entitou XML 1,0.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].

Poznámky

Při vytváření čtecího modulu XML nebo instance zapisovače můžete pomocí XmlReaderSettings XmlWriterSettings třídy nebo určit funkce, které má nová instance podporovat.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. Jednou z funkcí, které lze konfigurovat, je úroveň shody, kterou chcete pro data XML vyhovět.One of the features that you can configure is the level of conformance you want to enforce on the XML data.

Vytvořením kompatibilního čtecího modulu nebo zapisovače se zaručí, že zpracovaná data XML vyhovují zadané úrovni shody.Creating a compliant reader or writer guarantees that the XML data being processed complies with the specified conformance level. Pokud datový proud, který čte nebo zapisuje, není v souladu s úrovní dodržování úrovně, je vyvolána výjimka.If the stream being read or written doesn't comply with the conformance level, an exception is thrown.

Kontroly na úrovni dokumentu s ConformanceLevel.Document členem výčtu vynutily kontroly na úrovni fragmentu ( ConformanceLevel.Fragment člen) a také zajišťují následující:Document-level checks with the ConformanceLevel.Document enumeration member enforce fragment-level checks (the ConformanceLevel.Fragment member) and also ensure the following:

  • Položka nejvyšší úrovně neobsahuje žádné uzly jiné než deklarace XML, DTD, element, komentář, prázdné místo nebo instrukce pro zpracování.The top-level item doesn't have any nodes other than the XML declaration, DTD, element, comment, white space, or processing instruction.

  • Data XML mají jeden a pouze jeden uzel element nejvyšší úrovně.The XML data has one and only one top-level element node.

Platí pro

Viz také