XmlReaderSettings.ConformanceLevel Propriedade

public:
 property System::Xml::ConformanceLevel ConformanceLevel { System::Xml::ConformanceLevel get(); void set(System::Xml::ConformanceLevel value); };

public System.Xml.ConformanceLevel ConformanceLevel { get; set; }

member this.ConformanceLevel : System.Xml.ConformanceLevel with get, set

Public Property ConformanceLevel As ConformanceLevel

Valor de Propriedade

Um dos valores de enumeração que especifica o nível de conformidade que o leitor XML irá aplicar. A predefinição é Document.

Exemplos

O exemplo seguinte cria um XmlReader objeto que lê um fragmento XML.

string xmlFrag ="<item rk:ID='abc-23'>hammer</item> " +
                        "<item rk:ID='r2-435'>paint</item>" +
                        "<item rk:ID='abc-39'>saw</item>";

// Create the XmlNamespaceManager.
NameTable nt = new NameTable();
XmlNamespaceManager nsmgr = new XmlNamespaceManager(nt);
nsmgr.AddNamespace("rk", "urn:store-items");

// Create the XmlParserContext.
XmlParserContext context = new XmlParserContext(null, nsmgr, null, XmlSpace.None);

// Create the reader.
XmlReaderSettings settings = new XmlReaderSettings();
settings.ConformanceLevel = ConformanceLevel.Fragment;
XmlReader reader = XmlReader.Create(new StringReader(xmlFrag), settings, context);

Dim xmlFrag As String = "<item rk:ID='abc-23'>hammer</item> " & _
                                     "<item rk:ID='r2-435'>paint</item>" & _
                                     "<item rk:ID='abc-39'>saw</item>"

' Create the XmlNamespaceManager.
Dim nt As New NameTable()
Dim nsmgr As New XmlNamespaceManager(nt)
nsmgr.AddNamespace("rk", "urn:store-items")

' Create the XmlParserContext.
Dim context As New XmlParserContext(Nothing, nsmgr, Nothing, XmlSpace.None)

' Create the reader. 
Dim settings As New XmlReaderSettings()
settings.ConformanceLevel = ConformanceLevel.Fragment
Dim reader As XmlReader = XmlReader.Create(New StringReader(xmlFrag), settings, context)

Observações

Os leitores XML criados pelo método Create atendem aos seguintes requisitos de conformidade por padrão:

• Novas linhas e valor de atributo são normalizados de acordo com a Recomendação W3C XML 1.0.

• Todas as entidades são expandidas automaticamente.

• Os atributos padrão declarados na definição do tipo de documento são sempre adicionados mesmo quando o leitor não valida.

• É permitida a declaração do prefixo XML mapeado para o URI do namespace XML correto.

• Os nomes de notação em uma única declaração de atributo NotationType e NmTokens em uma única declaração de atributo Enumeration são distintos.

Pode usar a ConformanceLevel propriedade para verificar e garantir que o fluxo a ser lido cumpre as regras para um documento ou fragmento de documento XML 1.0 bem formado. Se os dados não cumprirem, é lançada uma XmlException exceção. O padrão é ConformanceLevel.Document (conformidade ao nível do documento).

Os três níveis de conformidade são:

Eis como o leitor lida com violações específicas de conformidade dependendo do contexto da ConformanceLevel propriedade:

Ver também

• Create(String)