ConformanceLevel Enumeración

Definición

Especifica el número de comprobaciones de entrada o de salida que realizan los objetos XmlReader y 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
Herencia
ConformanceLevel

Campos

Auto 0

Los objetos XmlReader o XmlWriter detectan automáticamente si se debe realizar la comprobación del documento o fragmento y lleva a cabo la comprobación correspondiente.The XmlReader or XmlWriter object automatically detects whether document-level or fragment-level checking should be performed, and does the appropriate checking. Si está ajustando otro objeto XmlReader o XmlWriter, el objeto externo no lleva a cabo ninguna comprobación de conformidad adicional.If you're wrapping another XmlReader or XmlWriter object, the outer object doesn't do any additional conformance checking. La comprobación de conformidad se deja al objeto subyacente.Conformance checking is left up to the underlying object.

Vea las propiedades ConformanceLevel y ConformanceLevel para más información sobre cómo se determina el nivel de cumplimiento.See the ConformanceLevel and ConformanceLevel properties for details on how the compliance level is determined.

Document 2

Los datos XML cumplen con las reglas de un documento XML 1.0 con el formato correcto, tal como define W3C.The XML data complies with the rules for a well-formed XML 1.0 document, as defined by the W3C. Este nivel de comprobación garantiza que el flujo que se lee o escribe pueda consumirse por cualquier procesador como un 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 1

Los datos XML son un fragmento XML con el formato correcto, tal como define W3C.The XML data is a well-formed XML fragment, as defined by the W3C. Este nivel de conformidad representa un documento XML que puede que no tenga un elemento raíz, pero que está bien formado.This conformance level represents an XML document that might not have a root element but is otherwise well-formed. Este nivel de comprobación garantiza que el flujo que se lee o escribe pueda consumirse por cualquier procesador como una entidad analizada externa 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].

Comentarios

Cuando se crea una instancia de lector o escritor XML, se puede utilizar XmlReaderSettings la XmlWriterSettings clase o para especificar las características que desea que la nueva instancia admita.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 de las características que puede configurar es el nivel de conformidad que desea aplicar en los datos XML.One of the features that you can configure is the level of conformance you want to enforce on the XML data.

La creación de un lector o escritor compatible garantiza que los datos XML que se procesan cumplan el nivel de cumplimiento especificado.Creating a compliant reader or writer guarantees that the XML data being processed complies with the specified conformance level. Si la secuencia que se lee o se escribe no cumple con el nivel de conformidad, se produce una excepción.If the stream being read or written doesn't comply with the conformance level, an exception is thrown.

Las comprobaciones de nivel de documento con el ConformanceLevel.Document miembro de enumeración exigen comprobaciones de nivel de fragmento (el ConformanceLevel.Fragment miembro) y también garantizan lo siguiente:Document-level checks with the ConformanceLevel.Document enumeration member enforce fragment-level checks (the ConformanceLevel.Fragment member) and also ensure the following:

  • El elemento de nivel superior no tiene ningún nodo distinto de la declaración XML, DTD, elemento, comentario, espacio en blanco o instrucción de procesamiento.The top-level item doesn't have any nodes other than the XML declaration, DTD, element, comment, white space, or processing instruction.

  • Los datos XML tienen uno y solo un nodo de elemento de nivel superior.The XML data has one and only one top-level element node.

Se aplica a

Consulte también