Realiza o parse XML de um arquivo, através do parâmetro recebido indicando o local do arquivo XML, podendo especificar a codificação do XML e opções para alterar o comportamento do parser. Se o parse for realizado com sucesso, é construida a árvore do XML.
Sintaxe
lRet := ReadFile( < cXmlFile >, [ cEncoding ], [ nOptions ] ) |
Parâmetros
Nome | Tipo | Descrição | Obrigatório | Referência |
|---|---|---|---|---|
cXmlFile | caractere | Indica o diretório (a partir do rootpath) e o nome de um arquivo *.xml. | X | |
cEncoding | caractere | Indica a codificação do documento. | ||
nOptions | numérico | Indica a combinação do xmlParserOption. |
Retorno
Nome | Tipo | Descrição |
|---|---|---|
lRet | lógico | Retorna verdadeiro (.T.) caso tenha sido realizado o parse com sucesso. Caso contrário, falso (.F.). |
Observações
- Caso não tenha sido possível realizar o parser XML, verifique os erros ou avisos através dos métodos Error e Warning.
- Ao ser realizado o parser, automáticamente a classe irá posicionar o nó corrente no nó raiz do XML.
- O parâmetro <cXmlFile> aceita apenas caminho de arquivos do server. Caso contrário mostrará o erro "Invalid XML File – Only Server Path allowed".
- Caso o parâmetro <cEncoding> não seja informado, a método utilizará o encondig padrão contindo no XML.