ILSParser Interface

Referência

Definição

Namespace:: Org.W3c.Dom.LS

Assembly:: Mono.Android.dll

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: RegisterAttribute

Implementações: IJavaObject IJavaPeerable IDisposable

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 [attributes] 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>Nota: 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:

&lt;!DOCTYPE root [ &lt;!ENTITY e SYSTEM 'subdir/myentity.ent' ]&gt;
            &lt;root&gt; &amp;e; &lt;/root&gt;

E subdir/myentity.ent contém:

&lt;one&gt; &lt;two/&gt; &lt;/one&gt; &lt;?pi 3.14159?&gt;
            &lt;more/&gt;

</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	`true`se o for assíncrono, `false` se for síncrono`LSParser`.
Busy	`true` se o estiver ocupado `LSParser` carregando um documento, caso contrário `false`.
DomConfig	O `DOMConfiguration` objeto usado ao analisar uma fonte de entrada.
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 `java.lang.System.identityHashCode()` para a instância encapsulada. (Herdado de IJavaPeerable)
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 `LSParser`.
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 `Dispose()`, caso contrário, não faz nada. (Herdado de IJavaPeerable)
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 `LSInput`arquivo .
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 `LSInput` e insira o conteúdo em um documento existente na posição especificada com os `context` argumentos e `action` .
SetJniIdentityHashCode(Int32)	Defina o valor retornado por `JniIdentityHashCode`. (Herdado de IJavaPeerable)
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 `PeerReference`. (Herdado de IJavaPeerable)
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.

Aplica-se a

Compartilhar via