validate Method

9/8/2008

Executa executar-validação tempo no documento carregado no momento usando o documento carregado no momento tipo definição (DTD Document Type DEFINITION), esquema ou coleção esquema.

Sintaxe de script

objXMLDOMDocument2.validate();

Comentários

Parâmetros de script

Nenhum.

Valor Return script

A ParseError objeto indicando exatamente qual erro ocorreu, se houver algum.

C/sintaxe C++

HRESULT validate(
  IXMLDOMParseError** errorObj
);

Comentários

C/parâmetros C++

• errorObj
  [retval, saída] IErrorInfo contendo um formatado indicando exatamente qual saiu errado e outra da seguinte mensagem de erro HRESULTs (também retornados na ErrorInfo.Number propriedade).

C/valores Return C++

Return valor	Valor hexadecimal	Descrição
E_PENDING	0x8000000A	Documento readyState Property (DOMDocument) não é 4, indicando que o documento não está completamente carregado.
S_OK	0	O documento é válido de acordo com o DTD ou esquemas.
S_FALSE	1	O documento é inválido de acordo com o DTD ou esquemas. Para obter informações de erro, consulte o retornado IXMLDOMParseError WScript.Shell.

O seguinte validação possíveis erros retornados com S_FALSE são listados, em conjunto com o errorCode valor.

ID da Mensagem	Código de erro (valor hex)	Mensagem
XML_E_NODTD	0xC00CE224	Valide falha porque um DTD ou esquema não foi especificada no documento.
XML_E_NOTWF	0xC00CE223	Valide falha porque o documento não contém exatamente um nó raiz.
XML_ENTITY_UNDEFINED	0xC00CE002	Referência ao indefinido entidade '%1'.
XML_INFINITE_ENTITY_LOOP	0xC00CE003	Entidade '%1 Contém um executar um loop referência de entidade infinito.
XML_NDATA_INVALID_PE	0xC00CE004	Não é possível usar a palavra-chave NDATA na declaração de uma entidade de parâmetro.
XML_REQUIRED_NDATA	0xC00CE005	Não é possível usar uma entidade geral analisada '%1 Como o valor de atributo '%2'.
XML_NDATA_INVALID_REF	0xC00CE006	Não é possível usar não analisado entidade '%1 Em um referência de entidade.
XML_EXTENT_IN_ATTR	0xC00CE007	Não é possível fazer referência um externo geral analisada entidade '%1 Em um valor atributo.
XML_ELEMENT_UNDECLARED	0xC00CE00D	O elemento '%1 é usado mas não declarado no DTD ou esquema.
XML_ELEMENT_ID_NOT_FOUND	0xC00CE00E	O atributo '%1 Referências a identificação '%2', que não está definida no documento.
XML_EMPTY_NOT_ALLOWED	0xC00CE011	Elemento não pode ser vazio de acordo com o DTD ou esquema.
XML_ELEMENT_NOT_COMPLETE	0xC00CE012	Elemento de conteúdo está incompleta de acordo com o DTD ou esquema.
XML_ROOT_NAME_MISMATCH	0xC00CE013	O nome do elemento de Top-Most deve corresponder ao nome da declaração DOCTYPE.
XML_INVALID_CONTENT	0xC00CE014	Elemento de conteúdo é inválido de acordo com o DTD ou esquema.
XML_ATTRIBUTE_NOT_DEFINED	0xC00CE015	O atributo '%1 Sobre este elemento não está definido no DTD ou esquema.
XML_ATTRIBUTE_FIXED	0xC00CE016	Atributo '%1 Um valor que não corresponde a valor fixo definiu no DTD ou esquema.
XML_ATTRIBUTE_VALUE	0xC00CE017	Atributo '%1 tem um valor inválido de acordo com o DTD ou esquema.
XML_ILLEGAL_TEXT	0xC00CE018	Texto não é permitido neste elemento de acordo com o DTD ou esquema.
XML_MULTI_FIXED_VALUES	0xC00CE019	Uma declaração de atributo não pode conter múltiplos valores fixos: '%1'.
XML_ELEMENT_UNDEFINED	0xC00CE01C	Referência a um elemento não declarado: '%1'.
XML_XMLNS_FIXED	0xC00CE01E	Atributo '%1 Deve ser um atributo #FIXED.
XML_REQUIRED_ATTRIBUTE_MISSING	0xC00CE020	Atributo necessário '%1 não existe.
XML_DTD_EXPECTING	0xC00CE026	Esperando: %1.
XML_E_NODTD	0xC00CE224	Valide falha porque um DTD ou esquema não foi especificada no documento.

Requisitos

Header	msxml2.h, msxml2.idl
Library	uuid.lib
Windows Embedded CE	Windows CE .NET 4.0 and later

Comentários Gerais

Este método somente valida totalmente carregados documentos (ReadyState == 4).

O Validar método retorna IXMLDOMParseError que é independente do valor retornado pela parseError propriedade em um documento. Somente o errorCode e Razão Propriedades do valor retornado são definidas.

Ao contrário carregar, Validar falhará se há um DTD ou esquema aplicada ao elemento de documento. Portanto, Validar Não será possível informar se o documento é somente válido.

O Validar método não analisa novos esquemas, mas pode importação um esquema de um SchemaCache associado com o documento através de Esquemas propriedade. Se não houver nenhum esquema de um determinado espaço para nome, os elementos desse espaço para nome não irão ser validados.

Este método se aplica à seguinte interface:

IXMLDOMDocument2.