ConformanceLevel Enumeração

Definição

Especifica a quantidade de verificação de entrada ou saída que os objetos XmlReader e XmlWriter executam.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
Herança
ConformanceLevel

Campos

Auto 0

O objeto XmlReader ou XmlWriter detecta automaticamente se a verificação do nível do documento ou do nível do fragmento deve ser executada e realiza a verificação apropriada.The XmlReader or XmlWriter object automatically detects whether document-level or fragment-level checking should be performed, and does the appropriate checking. Se você estiver encapsulando outro objeto XmlReader ou XmlWriter, o objeto externo não executará nenhuma verificação de compatibilidade adicional.If you're wrapping another XmlReader or XmlWriter object, the outer object doesn't do any additional conformance checking. A verificação de compatibilidade é deixada a cargo do objeto subjacente.Conformance checking is left up to the underlying object.

Consulte as propriedades ConformanceLevel e ConformanceLevel para obter detalhes sobre como o nível de conformidade é determinado.See the ConformanceLevel and ConformanceLevel properties for details on how the compliance level is determined.

Document 2

Os dados XML estão em conformidade com as regras para um documento XML 1.0 bem formado, conforme definido pelo W3C.The XML data complies with the rules for a well-formed XML 1.0 document, as defined by the W3C. Esse nível de verificação garante que o fluxo que está sendo lido ou gravado possa ser consumido por qualquer processador como um 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

Os dados XML são um fragmento de XML bem formado, conforme definido pelo W3C.The XML data is a well-formed XML fragment, as defined by the W3C. Esse nível de conformidade representa um documento XML que pode não ter um elemento raiz, mas que de outro modo é bem formado.This conformance level represents an XML document that might not have a root element but is otherwise well-formed. Esse nível de verificação garante que o fluxo que está sendo lido ou gravado possa ser consumido por qualquer processador como uma [entidade analisada 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].

Comentários

Ao criar uma instância de leitor ou gravador XML, você pode usar a XmlReaderSettings XmlWriterSettings classe ou para especificar os recursos para os quais você deseja que a nova instância dê suporte.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. Um dos recursos que você pode configurar é o nível de conformidade que você deseja impor nos dados XML.One of the features that you can configure is the level of conformance you want to enforce on the XML data.

A criação de um leitor ou gravador compatível garante que os dados XML que estão sendo processados estejam em conformidade com o nível de conformidade especificado.Creating a compliant reader or writer guarantees that the XML data being processed complies with the specified conformance level. Se o fluxo que está sendo lido ou gravado não estiver em conformidade com o nível de conformidade, uma exceção será lançada.If the stream being read or written doesn't comply with the conformance level, an exception is thrown.

Verificações em nível de documento com o ConformanceLevel.Document membro de enumeração impõem verificações em nível de fragmento (o ConformanceLevel.Fragment membro) e também garantem o seguinte:Document-level checks with the ConformanceLevel.Document enumeration member enforce fragment-level checks (the ConformanceLevel.Fragment member) and also ensure the following:

  • O item de nível superior não tem nenhum outro nó além da declaração XML, do DTD, do elemento, do comentário, do espaço em branco ou da instrução de processamento.The top-level item doesn't have any nodes other than the XML declaration, DTD, element, comment, white space, or processing instruction.

  • Os dados XML têm apenas um nó de elemento de nível superior.The XML data has one and only one top-level element node.

Aplica-se a

Confira também