ConformanceLevel ConformanceLevel ConformanceLevel ConformanceLevel Enum

Definizione

Specifica il livello di controllo dell'input o dell'output eseguito dagli oggetti XmlReader e XmlWriter.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
Ereditarietà
ConformanceLevelConformanceLevelConformanceLevelConformanceLevel

Campi

Auto Auto Auto Auto 0

L'oggetto XmlReader o XmlWriter rileva automaticamente se il controllo deve essere eseguito a livello di documento o di frammento e procede nel modo appropriato.The XmlReader or XmlWriter object automatically detects whether document-level or fragment-level checking should be performed, and does the appropriate checking. Se viene eseguito il wrapping di un altro oggetto XmlReader o XmlWriter, l'oggetto esterno non esegue altri controlli di conformità.If you're wrapping another XmlReader or XmlWriter object, the outer object doesn't do any additional conformance checking. Il controllo di conformità viene eseguito fino al livello dell'oggetto sottostante.Conformance checking is left up to the underlying object.

Per informazioni su come viene determinato il livello di conformità, vedere le proprietà ConformanceLevel e ConformanceLevel.See the ConformanceLevel and ConformanceLevel properties for details on how the compliance level is determined.

Document Document Document Document 2

I dati XML sono conformi alle regole per un documento XML 1.0 ben formato, in base alla definizione di W3C.The XML data complies with the rules for a well-formed XML 1.0 document, as defined by the W3C. Questo livello di controllo assicura che il flusso dei dati letto o scritto possa essere utilizzato da qualsiasi processore come documento 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 Fragment Fragment Fragment 1

I dati XML sono un frammento XML ben formato, in base alla definizione di W3C.The XML data is a well-formed XML fragment, as defined by the W3C. Questo livello di conformità rappresenta un documento XML che potrebbe non avere un elemento radice, ma che per il resto è ben formato.This conformance level represents an XML document that might not have a root element but is otherwise well-formed. Questo livello di controllo assicura che il flusso dei dati letto o scritto possa essere utilizzato da qualsiasi processore come entità analizzata esterna 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].

Commenti

Quando si crea un'istanza di un lettore o writer XML, è possibile usare la XmlReaderSettings o XmlWriterSettings classe per specificare le funzionalità che si desidera che la nuova istanza per il supporto.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. Una delle funzionalità che è possibile configurare è il livello di conformità da applicare sui dati XML.One of the features that you can configure is the level of conformance you want to enforce on the XML data.

Creazione di un writer o un lettore conformi garantisce che i dati XML in fase di elaborazione sia conforme con il livello di conformità specificato.Creating a compliant reader or writer guarantees that the XML data being processed complies with the specified conformance level. Se il flusso che viene letto o scritto non è conforme al livello di conformità, viene generata un'eccezione.If the stream being read or written doesn't comply with the conformance level, an exception is thrown.

A livello di documento verifiche con il ConformanceLevel.Document membro dell'enumerazione Applica controlli a livello di frammento (il ConformanceLevel.Fragment membro) e verificare inoltre quanto segue:Document-level checks with the ConformanceLevel.Document enumeration member enforce fragment-level checks (the ConformanceLevel.Fragment member) and also ensure the following:

  • L'elemento di primo livello non presentare altri nodi oltre la dichiarazione XML, DTD, elemento, commento, spazi vuoti o istruzione di elaborazione.The top-level item doesn't have any nodes other than the XML declaration, DTD, element, comment, white space, or processing instruction.

  • I dati XML hanno un solo nodo di elemento di primo livello.The XML data has one and only one top-level element node.

Si applica a

Vedi anche