Compartilhar via


XmlValidatingReader Construtores

Definição

Inicializa uma nova instância da classe XmlValidatingReader.

Sobrecargas

Nome Description
XmlValidatingReader(XmlReader)

Inicializa uma nova instância da XmlValidatingReader classe que valida o conteúdo retornado do determinado 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 retornado do determinado 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

A XmlReader leitura a ser lida durante a validação. A implementação atual dá suporte apenas XmlTextReadera .

Exceções

O leitor especificado não é um XmlTextReader.

Comentários

Observação

A XmlValidatingReader classe está obsoleta no .NET Framework 2.0. Você 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 de Comentários da página de referência XmlReader.

Todos os nós retornados do determinado XmlReader também são retornados desse leitor de validação, portanto, não há nenhuma perda de informações no processo. Novos nós não retornados do leitor subjacente podem ser adicionados por este leitor (por exemplo, atributos padrão e filhos de uma referência de entidade). Todas as propriedades definidas no determinado XmlTextReader também se aplicam a esse leitor de validação. Por exemplo, se o leitor fornecido tiver WhitespaceHandling.None definido, esse leitor de validação também ignorará o espaço em branco.

Quando as definições de tipo de documento externo (DTDs) ou esquemas são necessários para validação, a XmlResolver propriedade define o XmlResolver objeto a ser usado para resolver recursos externos.

Confira 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 que contém o fragmento XML a ser analisado.

fragType
XmlNodeType

O XmlNodeType fragmento XML. Isso determina o que o fragmento pode conter (confira a tabela abaixo).

context
XmlParserContext

O XmlParserContext fragmento XML no qual o fragmento XML deve ser analisado. Isso inclui o XmlNameTable uso, codificação, escopo do namespace, atual xml:lange xml:space escopo.

Exceções

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

Comentários

Observação

A XmlValidatingReader classe está obsoleta no .NET Framework 2.0. Você 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 de Comentários da página de referência XmlReader.

Esse construtor analisa a cadeia de caracteres fornecida como um fragmento de XML. Se o fragmento XML for um elemento ou atributo, você poderá ignorar as regras de nível raiz para documentos XML bem formados.

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

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

O leitor usa as seguintes etapas 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 verificará uma marca de ordem de byte no início do fluxo.

  3. Se a Encoding propriedade for null, e nenhuma marca de ordem de byte for encontrada, o leitor assumirá que o fluxo está codificado em UTF-8.

Se esse leitor estiver validando usando dtd (definição de tipo de documento) (ou seja, ValidationType está definido como ValidationType.DTD ou ValidationType.Auto), o XmlParserContext construtor especificado deve fornecer todas as informações necessárias do DocumentType.

Observação

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

Se esse leitor estiver validando usando esquemas XDR (redução de XML-Data) ou XSD (linguagem de definição de esquema XML), use a Schemas propriedade para especificar o XmlSchemaCollection que contém os esquemas (ou seja, não XmlParserContext é necessário fornecer as informações do DocumentType).

Confira 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 de caracteres que contém o fragmento XML a ser analisado.

fragType
XmlNodeType

O XmlNodeType fragmento XML. Isso também determina o que a cadeia de caracteres de fragmento pode conter (confira a tabela abaixo).

context
XmlParserContext

O XmlParserContext fragmento XML no qual o fragmento XML deve ser analisado. Isso inclui o NameTable escopo de uso, codificação, namespace, xml:lang atual e xml:space.

Exceções

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

Comentários

Observação

A XmlValidatingReader classe está obsoleta no .NET Framework 2.0. Você 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 de Comentários da página de referência XmlReader.

Esse construtor analisa a cadeia de caracteres fornecida como um fragmento de XML. Se o fragmento XML for um elemento ou atributo, você poderá ignorar as regras de nível raiz para documentos XML bem formados. Esse construtor pode manipular cadeias de caracteres retornadas de ReadInnerXml.

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

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

Se esse leitor estiver validando usando dtd (definição de tipo de documento) (ou seja, ValidationType é definido como ValidationType.DTD ou ValidationType.Auto), o XmlParserContext construtor especificado deve fornecer todas as informações necessárias do DocumentType.

Observação

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

Se esse leitor estiver validando usando esquemas XDR (redução de XML-Data) ou XSD (linguagem de definição de esquema XML), use a Schemas propriedade para especificar o XmlSchemaCollection que contém os esquemas (não XmlParserContext é necessário fornecer as informações do DocumentType).

Confira também

Aplica-se a