XmlValidatingReader Construtores

Definição

Inicializa uma nova instância da XmlValidatingReader classe.

Sobrecargas

Name Description
XmlValidatingReader(XmlReader)

Inicializa uma nova instância da XmlValidatingReader classe que valida o conteúdo devolvido do dado XmlReader.

XmlValidatingReader(Stream, XmlNodeType, XmlParserContext)

Inicializa uma nova instância da XmlValidatingReader classe com os valores especificados.

XmlValidatingReader(String, XmlNodeType, XmlParserContext)

Inicializa uma nova instância da XmlValidatingReader classe com os valores especificados.

XmlValidatingReader(XmlReader)

Origem:
XmlValidatingReader.cs
Origem:
XmlValidatingReader.cs
Origem:
XmlValidatingReader.cs
Origem:
XmlValidatingReader.cs
Origem:
XmlValidatingReader.cs

Inicializa uma nova instância da XmlValidatingReader classe que valida o conteúdo devolvido do dado XmlReader.

public:
 XmlValidatingReader(System::Xml::XmlReader ^ reader);
public XmlValidatingReader(System.Xml.XmlReader reader);
new System.Xml.XmlValidatingReader : System.Xml.XmlReader -> System.Xml.XmlValidatingReader
Public Sub New (reader As XmlReader)

Parâmetros

reader
XmlReader

O XmlReader para ler enquanto validas. A implementação atual suporta apenas XmlTextReader.

Exceções

O leitor especificado não é um XmlTextReader.

Observações

Note

A classe XmlValidatingReader está obsoleta no .NET Framework 2.0. Pode criar uma instância de validação XmlReader usando a XmlReaderSettings classe e o Create método. Para obter mais informações, consulte a seção Comentários da XmlReader página de referência.

Todos os nós devolvidos do dado XmlReader também são devolvidos deste leitor de validação, pelo que não há perda de informação no processo. Novos nós não retornados do leitor subjacente podem ser adicionados por este leitor (por exemplo, atributos padrão e os filhos de uma referência de entidade). Quaisquer propriedades definidas no dado XmlTextReader também se aplicam a este leitor validador. Por exemplo, se o leitor fornecido tinha WhitespaceHandling.None ativado, este leitor validador também ignora o espaço em branco.

Quando são necessárias definições de tipos de documentos externos (DTDs) ou esquemas para validação, a XmlResolver propriedade define o XmlResolver objeto a usar para resolver recursos externos.

Ver também

Aplica-se a

XmlValidatingReader(Stream, XmlNodeType, XmlParserContext)

Origem:
XmlValidatingReader.cs
Origem:
XmlValidatingReader.cs
Origem:
XmlValidatingReader.cs
Origem:
XmlValidatingReader.cs
Origem:
XmlValidatingReader.cs

Inicializa uma nova instância da XmlValidatingReader classe com os valores especificados.

public:
 XmlValidatingReader(System::IO::Stream ^ xmlFragment, System::Xml::XmlNodeType fragType, System::Xml::XmlParserContext ^ context);
public XmlValidatingReader(System.IO.Stream xmlFragment, System.Xml.XmlNodeType fragType, System.Xml.XmlParserContext context);
new System.Xml.XmlValidatingReader : System.IO.Stream * System.Xml.XmlNodeType * System.Xml.XmlParserContext -> System.Xml.XmlValidatingReader
Public Sub New (xmlFragment As Stream, fragType As XmlNodeType, context As XmlParserContext)

Parâmetros

xmlFragment
Stream

O fluxo contendo o fragmento XML para analisar.

fragType
XmlNodeType

O XmlNodeType do fragmento XML. Isto determina o que o fragmento pode conter (ver tabela abaixo).

context
XmlParserContext

O XmlParserContext em que o fragmento XML deve ser analisado. Isto inclui o XmlNameTable to use, codificação, âmbito do espaço de nomes, corrente xml:lange xml:space âmbito.

Exceções

fragType não é um dos tipos de nós listados na tabela abaixo.

Observações

Note

A classe XmlValidatingReader está obsoleta no .NET Framework 2.0. Pode criar uma instância de validação XmlReader usando a XmlReaderSettings classe e o Create método. Para obter mais informações, consulte a seção Comentários da XmlReader página de referência.

Este construtor analisa a cadeia dada como um fragmento de XML. Se o fragmento XML for um elemento ou atributo, pode contornar as regras de nível raiz para documentos XML bem formados.

A tabela seguinte lista valores válidos para fragType e como o leitor analisa cada um dos diferentes tipos de nós.

XmlNodeType Fragmento pode conter
Elemento Qualquer conteúdo válido de elementos (por exemplo, qualquer combinação de elementos, comentários, instruções de processamento, cdata, texto e referências de entidades).
Attribute O valor de um atributo (a parte dentro das aspas).
Documento O conteúdo de um documento XML completo; Isto aplica regras ao nível do documento.

O leitor utiliza os seguintes passos para determinar a codificação do fluxo:

  1. Verifica a XmlParserContext.Encoding propriedade para determinar a codificação.

  2. Se a Encoding propriedade for null, o leitor verifica se há uma marca de ordem de bytes no início do fluxo.

  3. Se a Encoding propriedade for null, e não for encontrada marca de ordem de bytes, o leitor assume que o fluxo está codificado em UTF-8.

Se este leitor estiver a validar usando a definição do tipo de documento (DTD) (isto é, ValidationType está definido como ValidationType.DTD ou ValidationType.Auto), o XmlParserContext especificado no construtor deve fornecer toda a informação necessária do DocumentType.

Note

Não é possível validar um fragmento usando uma DTD. Por definição, um DTD requer que um documento inteiro seja carregado para validação.

Se este leitor estiver a validar usando XML-Data esquemas Reduced (XDR) ou XML Schema definition language (XSD), use a Schemas propriedade para especificar que XmlSchemaCollection contém os esquemas (ou seja, não XmlParserContext precisa de fornecer a informação DocumentType).

Ver também

Aplica-se a

XmlValidatingReader(String, XmlNodeType, XmlParserContext)

Origem:
XmlValidatingReader.cs
Origem:
XmlValidatingReader.cs
Origem:
XmlValidatingReader.cs
Origem:
XmlValidatingReader.cs
Origem:
XmlValidatingReader.cs

Inicializa uma nova instância da XmlValidatingReader classe com os valores especificados.

public:
 XmlValidatingReader(System::String ^ xmlFragment, System::Xml::XmlNodeType fragType, System::Xml::XmlParserContext ^ context);
public XmlValidatingReader(string xmlFragment, System.Xml.XmlNodeType fragType, System.Xml.XmlParserContext context);
new System.Xml.XmlValidatingReader : string * System.Xml.XmlNodeType * System.Xml.XmlParserContext -> System.Xml.XmlValidatingReader
Public Sub New (xmlFragment As String, fragType As XmlNodeType, context As XmlParserContext)

Parâmetros

xmlFragment
String

A cadeia que contém o fragmento XML para analisar.

fragType
XmlNodeType

O XmlNodeType do fragmento XML. Isto também determina o que a cadeia de fragmentos pode conter (ver tabela abaixo).

context
XmlParserContext

O XmlParserContext em que o fragmento XML deve ser analisado. Isto inclui o NameTable to use, codificação, âmbito do namespace, xml:lang atual e xml:space.

Exceções

fragType não é um dos tipos de nós listados na tabela abaixo.

Observações

Note

A classe XmlValidatingReader está obsoleta no .NET Framework 2.0. Pode criar uma instância de validação XmlReader usando a XmlReaderSettings classe e o Create método. Para obter mais informações, consulte a seção Comentários da XmlReader página de referência.

Este construtor analisa a cadeia dada como um fragmento de XML. Se o fragmento XML for um elemento ou atributo, pode contornar as regras de nível raiz para documentos XML bem formados. Este construtor pode tratar cadeias retornadas de ReadInnerXml.

A tabela seguinte lista valores válidos para fragType e como o leitor analisa cada um dos diferentes tipos de nós.

XmlNodeType Fragmento pode conter
Elemento Qualquer conteúdo válido de elementos (por exemplo, qualquer combinação de elementos, comentários, instruções de processamento, cdata, texto e referências de entidades).
Attribute O valor de um atributo (a parte dentro das aspas).
Documento O conteúdo de um documento XML completo; Isto aplica regras ao nível do documento.

Se este leitor estiver a validar usando a definição do tipo de documento (DTD) (ou seja, ValidationType está definido como ValidationType.DTD ou ValidationType.Auto), o XmlParserContext especificado no construtor deve fornecer toda a informação necessária do DocumentType.

Note

Não é possível validar um fragmento usando DTD. Por definição, o DTD exige que um documento inteiro seja carregado para validação.

Se este leitor estiver a validar usando XML-Data esquemas Reduced (XDR) ou XML Schema definition language (XSD), use a Schemas propriedade para especificar que XmlSchemaCollection contém os esquemas (não XmlParserContext precisa de fornecer a informação DocumentType).

Ver também

Aplica-se a