ILSParser Interface
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Uma interface para um objeto que é capaz de construir, ou aumentar, uma árvore DOM a partir de várias fontes de entrada.
[Android.Runtime.Register("org/w3c/dom/ls/LSParser", "", "Org.W3c.Dom.LS.ILSParserInvoker")]
public interface ILSParser : Android.Runtime.IJavaObject, IDisposable, Java.Interop.IJavaPeerable[<Android.Runtime.Register("org/w3c/dom/ls/LSParser", "", "Org.W3c.Dom.LS.ILSParserInvoker")>]
type ILSParser = interface
interface IJavaObject
interface IDisposable
interface IJavaPeerable- Atributos
- Implementações
Comentários
Uma interface para um objeto que é capaz de construir, ou aumentar, uma árvore DOM a partir de várias fontes de entrada.
LSParser fornece uma API para analisar XML e criar a estrutura de documento DOM correspondente. Uma LSParser instância pode ser obtida invocando o DOMImplementationLS.createLSParser() método.
Conforme especificado em [DOM Level 3 Core] , quando um documento é disponibilizado pela primeira vez através do LSParser: <ul><li> nunca haverá dois nós adjacentes do tipo NODE_TEXT, e nunca haverá nós de texto vazios. </li><li> espera-se que os value atributos e nodeValue de um Attr nó retornem inicialmente o valor normalizado XML 1.0. No entanto, se os parâmetros " validate-if-schema" e " datatype-normalization" forem definidos como true, dependendo da normalização de atributo usada, os valores de atributo podem diferir daqueles obtidos pela normalização de atributo XML 1.0. Se os parâmetros " datatype-normalization" estiverem definidos como false, a normalização do atributo XML 1.0 terá garantia de ocorrer e, se a lista de atributos não contiver declarações de namespace, o attributes atributo no Element nó representará a propriedade <b>[attributes]</b> definida em [XML Information Set] . </li></ul>
Espera-se que os objetos assíncronos LSParser também implementem a events::EventTarget interface para que os ouvintes de eventos possam ser registrados em objetos assíncronos LSParser .
Os eventos suportados por objetos assíncronos LSParser são: <dl<>dt>load</dt><dd> Os LSParser acabamentos para carregar o documento. Veja também a definição da LSLoadEvent interface. </dd><dt>progress</dt><dd> Os sinais progridem à medida que LSParser os dados são analisados. Essa especificação não tenta definir exatamente quando os eventos de progresso devem ser despachados. Isso é intencionalmente deixado como dependente da implementação. Aqui está um exemplo de como um aplicativo pode despachar eventos de progresso: Quando o analisador começa a receber dados, um evento de progresso é despachado para indicar que a análise é iniciada. A partir daí, um evento de progresso é despachado para cada 4096 bytes de dados recebidos e processados. Este é apenas um exemplo, no entanto, e as implementações podem optar por despachar eventos de progresso a qualquer momento durante a análise ou não despachá-los. Veja também a definição da LSProgressEvent interface. </dd></dl><p ><b>Nota:</b> Todos os eventos definidos nesta especificação usam o URI "http://www.w3.org/2002/DOMLS"do namespace .
Ao analisar uma fonte de entrada, os erros são relatados ao aplicativo por meio do manipulador de erros (LSParser.domConfigparâmetro " error-handler" do manipulador de erros). Essa especificação não tenta de forma alguma definir todos os possíveis erros que podem ocorrer durante a análise de XML ou qualquer outra marcação, mas alguns casos de erro comuns são definidos. Os tipos (DOMError.type) de erros e avisos definidos por esta especificação são: <dl><dt"check-character-normalization-failure" [error]></dt><dd> Gerado se o parâmetro "check-character-normalization" estiver definido como true e for encontrada uma cadeia de caracteres que falha na verificação de normalização. </dd>dt><"doctype-not-allowed" [fatal]/dt<>dd> Gerado se o parâmetro de configuração "disallow-doctype" estiver definido como true e um doctype for encontrado.< </dd>dt><"no-input-specified" [fatal]/dt<>dd> Gerado ao carregar um documento e nenhuma entrada é especificada no LSInput objeto.< </dd>dt"pi-base-uri-not-preserved" [warning]></dt><dd> Gerado se uma instrução de processamento for encontrada em um local onde o URI base da instrução de processamento não pode ser preservado.< Um exemplo de um caso em que esse aviso será gerado é se o parâmetro de configuração " entities" estiver definido como false e o seguinte arquivo XML for analisado:
<!DOCTYPE root [ <!ENTITY e SYSTEM 'subdir/myentity.ent' ]>
<root> &e; </root>
E subdir/myentity.ent contém:
<one> <two/> </one> <?pi 3.14159?>
<more/>
</dd><dt"unbound-prefix-in-entity" [warning]<>/dt><dd> Um aviso dependente da implementação que pode ser gerado se o parâmetro de configuração " namespaces" estiver definido como true e um prefixo de namespace não acoplado for encontrado no texto de substituição de uma entidade. O acionamento desse aviso não é imposto, pois alguns analisadores existentes podem não reconhecer prefixos de namespace não acoplados no texto de substituição de entidades. </dd>dt><"unknown-character-denormalization" [fatal]/dt<>dd> Gerado se o parâmetro de configuração "ignore-unknown-character-denormalizations" estiver definido como false e for encontrado um caractere para o qual o processador não pode determinar as propriedades de normalização.< </dd>dt"unsupported-encoding" [fatal]></dt><dd> Gerado se uma codificação não suportada for encontrada.< </dd>dt><"unsupported-media-type" [fatal]/dt<>dd> Gerado se o parâmetro de configuração "supported-media-types-only" estiver definido como true e um tipo de mídia sem suporte for encontrado.< </dd></dl>
Além de gerar os erros e avisos definidos, espera-se que as implementações gerem erros e avisos específicos de implementação para quaisquer outros casos de erro e aviso, como erros de E/S (arquivo não encontrado, permissão negada,...), erros de bem-formação XML e assim por diante.
Consulte também a especificação de carregamento e salvamento de nível 3 do DOM (Document Object Model).
Documentação Java para org.w3c.dom.ls.LSParser.
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usado de acordo com os termos descritos na Creative Commons 2.5 Attribution License.
Campos
| ActionAppendAsChildren |
Acrescentar o resultado da operação de análise como filhos do nó de contexto. |
| ActionInsertAfter |
Insira o resultado da operação de análise como o irmão imediatamente seguinte do nó de contexto. |
| ActionInsertBefore |
Insira o resultado da operação de análise como o irmão imediatamente anterior do nó de contexto. |
| ActionReplace |
Substitua o nó de contexto pelo resultado da operação de análise. |
| ActionReplaceChildren |
Substitua todos os filhos do nó de contexto pelo resultado da operação de análise. |
Propriedades
| Async |
|
| Busy |
|
| DomConfig |
O |
| Filter |
Quando um filtro é fornecido, a implementação chamará o filtro à medida que ele estiver construindo a estrutura de árvore DOM. |
| Handle |
Obtém o valor JNI do objeto Android subjacente. (Herdado de IJavaObject) |
| JniIdentityHashCode |
Retorna o valor de |
| JniManagedPeerState |
Estado do par gerenciado. (Herdado de IJavaPeerable) |
| JniPeerMembers |
Acesso de membros e suporte à invocação. (Herdado de IJavaPeerable) |
| PeerReference |
Retorna uma JniObjectReference das instâncias do objeto Java encapsulado. (Herdado de IJavaPeerable) |
Métodos
| Abort() |
Anule o carregamento do documento que está sendo carregado atualmente pelo |
| Disposed() |
Chamado quando a instância tiver sido descartada. (Herdado de IJavaPeerable) |
| DisposeUnlessReferenced() |
Se não houver referências pendentes a este caso, então chame |
| Finalized() |
Chamado quando a instância tiver sido finalizada. (Herdado de IJavaPeerable) |
| Parse(ILSInput) |
Analisar um documento XML a partir de um recurso identificado por um |
| ParseURI(String) |
Analise um documento XML de um local identificado por uma referência de URI [IETF RFC 2396]. |
| ParseWithContext(ILSInput, INode, Int16) |
Analise um fragmento XML de um recurso identificado por um |
| SetJniIdentityHashCode(Int32) |
Defina o valor retornado por |
| SetJniManagedPeerState(JniManagedPeerStates) |
Uma interface para um objeto que é capaz de construir, ou aumentar, uma árvore DOM a partir de várias fontes de entrada. (Herdado de IJavaPeerable) |
| SetPeerReference(JniObjectReference) |
Defina o valor retornado por |
| UnregisterFromRuntime() |
Cancele o registro dessa instância para que o tempo de execução não a retorne de chamadas futuras Java.Interop.JniRuntime+JniValueManager.PeekValue . (Herdado de IJavaPeerable) |
Métodos de Extensão
| JavaCast<TResult>(IJavaObject) |
Executa uma conversão de tipo verificada em tempo de execução do Android. |
| JavaCast<TResult>(IJavaObject) |
Uma interface para um objeto que é capaz de construir, ou aumentar, uma árvore DOM a partir de várias fontes de entrada. |
| GetJniTypeName(IJavaPeerable) |
Uma interface para um objeto que é capaz de construir, ou aumentar, uma árvore DOM a partir de várias fontes de entrada. |
| ParseAsync(ILSParser, ILSInput) |
Uma interface para um objeto que é capaz de construir, ou aumentar, uma árvore DOM a partir de várias fontes de entrada. |
| ParseURIAsync(ILSParser, String) |
Uma interface para um objeto que é capaz de construir, ou aumentar, uma árvore DOM a partir de várias fontes de entrada. |
| ParseWithContextAsync(ILSParser, ILSInput, INode, Int16) |
Uma interface para um objeto que é capaz de construir, ou aumentar, uma árvore DOM a partir de várias fontes de entrada. |