IDOMConfiguration 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.
A DOMConfiguration interface representa a configuração de um documento e mantém uma tabela de parâmetros reconhecidos.
[Android.Runtime.Register("org/w3c/dom/DOMConfiguration", "", "Org.W3c.Dom.IDOMConfigurationInvoker")]
public interface IDOMConfiguration : Android.Runtime.IJavaObject, IDisposable, Java.Interop.IJavaPeerable[<Android.Runtime.Register("org/w3c/dom/DOMConfiguration", "", "Org.W3c.Dom.IDOMConfigurationInvoker")>]
type IDOMConfiguration = interface
interface IJavaObject
interface IDisposable
interface IJavaPeerable- Atributos
- Implementações
Comentários
A DOMConfiguration interface representa a configuração de um documento e mantém uma tabela de parâmetros reconhecidos. Usando a configuração, é possível alterar Document.normalizeDocument() o comportamento, como substituir os CDATASection nós por Text nós ou especificar o tipo do esquema que deve ser usado quando a validação do Document é solicitada. DOMConfiguration objetos também são usados em [DOM Nível 3 Carregar e Salvar] nas DOMParser interfaces e DOMSerializer .
Os nomes de DOMConfiguration parâmetros usados pelo objeto são definidos em todas as especificações do DOM Nível 3. Os nomes não diferenciam maiúsculas de minúsculas. Para evitar possíveis conflitos, como convenção, nomes referentes a parâmetros definidos fora da especificação DOM devem ser tornados únicos. Como os parâmetros são expostos como propriedades no , os nomes são recomendados para seguir a seção 5.16 Identificadores de [Unicode] com a adição do caractere '-' (HÍFEN-MENOS), mas isso não é imposto pela implementação do DOM. As implementações principais do DOM Nível 3 são necessárias para reconhecer todos os parâmetros definidos nesta especificação. Alguns valores de parâmetro também podem ser necessários para serem suportados pela implementação. Consulte a definição do parâmetro para saber se um valor deve ser suportado ou não. <p ><b>Nota:</b> Os parâmetros são semelhantes aos recursos e propriedades usados no SAX2 [SAX].
A seguinte lista de parâmetros definidos no DOM: <dl><dt"canonical-form"<>/dt><dd><dl<>dt><true/dt><dd>[<em>optional</em>] Canonicalize o documento de acordo com as regras especificadas em [Canonical XML], como remover o DocumentType nó (se houver) da árvore ou remover declarações de namespace supérfluas de cada elemento. Note que isso é limitado ao que pode ser representado no DOM; em particular, não há como especificar a ordem dos atributos no DOM. Além disso, a configuração desse parâmetro também true definirá o estado dos parâmetros listados abaixo. Alterações posteriores no estado de um desses parâmetros reverterão a "forma canônica" de volta para false. Parâmetros definidos como false: "entidades", "normalizar-caracteres", "cdata-seções". Parâmetros definidos como true: "namespaces", "namespace-declarations", "well-formed", "element-content-whitespace". Outros parâmetros não são alterados, a menos que explicitamente especificado na descrição dos parâmetros.</dd><dt>false</dt<>dd>[<em>required</em>] (<em>default</em>)Não canonizar o documento.</dd>/dl></dd<>dt<"cdata-sections">/dt><dd<>dl><dttrue></dt<>dd>[<em>required</em>] (<em>default</em>)Mantenha CDATASection nós no documento.<</dd><dt>false</dt<>dd>[<em>required</em>]Transforme CDATASection nós no documento em Text nós. O novo Text nó é então combinado com qualquer nó adjacenteText.</dd></dl></dd<>dt<>"check-character-normalization"/dt><dd<>dl><dttrue<>/dt<>dd>[<em>opcional</em>] Verifique se os caracteres no documento estão totalmente normalizados, conforme definido no apêndice B do [XML 1.1]. Quando uma sequência de caracteres é encontrada que falha na verificação de normalização, um erro com o DOMError.type igual a "check-character-normalization-failure" é emitido. </dd><dt>false</dt<>dd>[<em>required</em>] (<em>default</em>)Não verifique se os caracteres estão normalizados.</dd>/dl></dd<>dt<"comments">/dt><dd<>dl><dttrue></dt<>dd>[<em>required</em>] (<em>default</em>)Mantenha Comment nós no documento.<</dd><dt>false</dt><dd>[<em>required</em>]Descartar Comment nós no documento.</dd></dl></dd><dt"datatype-normalization"></dt<>dd<>dl><dt<true>/dt<>dd>[<em>optional</em>] Exponha valores normalizados de esquema na árvore, como valores normalizados de esquema XML no caso de esquema XML. Como esse parâmetro requer informações de esquema, o parâmetro "validate" também será definido como true. Ter esse parâmetro ativado quando "validar" é false não tem efeito e nenhuma normalização de esquema acontecerá. <p ><b>Nota:</b> Como o documento contém o resultado do processamento XML 1.0, esse parâmetro não se aplica à normalização do valor do atributo, conforme definido na seção 3.3.3 de [XML 1.0] e destina-se apenas a linguagens de esquema diferentes da DTD (Definição de Tipo de Documento). </dd>dt<false>/dt><dd>[<em>required</em>] (<em>default</em>) Não execute a normalização do esquema na árvore.< </dd>/dl></dd><dt>"element-content-whitespace"</dt<>dd<>dl<>dt><true/dt><dd>[<em>required</em>] (<em>default</em>)Mantenha todos os espaços em branco no documento.<</dd>dt>false</dt><dd>[<em>optional</em>] Descartar todos os Text nós que contêm espaços em branco no conteúdo do elemento, conforme descrito em [espaço em branco do conteúdo do elemento].< Espera-se que a implementação use o atributo Text.isElementContentWhitespace para determinar se um Text nó deve ser descartado ou não.</dd>/dl></dd<>dt<"entities">/dt><dd<>dl><dttrue></dt<>dd>[<em>required</em>] (<em>default</em>)Mantenha EntityReference nós no documento.<</dd><dtfalse></dt<>dd>[<em>required</em>] Remova todos os EntityReference nós do documento, colocando as expansões de entidade diretamente em seu lugar. Text nós são normalizados, conforme definido em Node.normalize. Somente referências de entidade não expandida são mantidas no documento. </dd></dl><p ><b>Nota:</b> Este parâmetro não afeta Entity nós. </dd><dt"error-handler"></dt<>dd>[<em>required</em>] Contém um DOMErrorHandler objeto. Se um erro for encontrado no documento, a implementação chamará de volta o DOMErrorHandler registrado usando esse parâmetro. A implementação pode fornecer um objeto padrão DOMErrorHandler . Quando chamado, DOMError.relatedData conterá o nó mais próximo de onde o erro ocorreu. Se a implementação não puder determinar o nó onde o erro ocorre, DOMError.relatedData conterá o Document nó. Mutações no documento de dentro de um manipulador de erros resultarão em comportamento dependente da implementação. </dd><dt"infoset"<>/dt<>dd<>dl<>dt><true/dt><dd>[<em>required</em>]Mantenha no documento as informações definidas no XML Information Set [XML Information Set] . Isso força os seguintes parâmetros afalse: " validate-if-schema", "entities", "datatype-normalization", "cdata-sections ". Isso força os seguintes parâmetros paratrue: " namespace-declarations", "well-formed", "element-content-whitespace", " comments", "namespaces". Outros parâmetros não são alterados, a menos que explicitamente especificado na descrição dos parâmetros. Observe que consultar esse parâmetro com getParameter retorna true somente se os parâmetros individuais especificados acima estiverem definidos adequadamente.</dd><dtfalse<>/dt><dd>A configuração infoset de para false não tem efeito.</dd></dl></dd<>dt<>"namespaces"/dt><dd<>dl><dttrue></dt<>dd>[<em>required</em>] (<em>default</em>) Execute o processamento do namespace conforme definido em . </dd><dt><false/dt><dd>[<em>optional</em>] Não execute o processamento do namespace. </dd>/dl></dd><dt><"namespace-declarations"/dt<>dd> Esse parâmetro não terá efeito se o parâmetro "namespaces" estiver definido como .false< <><dl dt<>true/dt<>dd>[<em>required</em>] (<em>default</em>) Inclua atributos de declaração de namespace, especificados ou padronizados do esquema, no documento. Consulte também as seções "Declarando namespaces" em [XML Namespaces] e [XML Namespaces 1.1] .</dd><dt><false/dt><dd>[<em>required</em>]Descartar todos os atributos de declaração de namespace. Os prefixos de namespace ( Node.prefix) são mantidos mesmo se esse parâmetro estiver definido como false.</dd></dl></dd<>dt<>"normalize-characters"/dt><dd<>dl><dttrue<>/dt><dd>[<em>optional</em>] Totalmente normalizados os caracteres no documento, conforme definido no apêndice B de [XML 1.1]. </dd><dt>false</dt<>dd>[<em>required</em>] (<em>default</em>)Não execute a normalização de caracteres.</dd></dl></dd<>dt><"schema-location"/dt><dd>[<em>optional</em>] Representa um DOMString objeto que contém uma lista de URIs, separados por espaços em branco (caracteres correspondentes ao S de produção não terminal definido na seção 2.3 [XML 1.0]), que representa os esquemas em relação aos quais a validação deve ocorrer, ou seja, o esquema atual. Os tipos de esquemas referenciados nesta lista devem corresponder ao tipo especificado com schema-type, caso contrário, o comportamento de uma implementação será indefinido. Os esquemas especificados usando essa propriedade têm precedência sobre as informações de esquema especificadas no próprio documento. Para o esquema com reconhecimento de namespace, se um esquema especificado usando essa propriedade e um esquema especificado na instância do documento (ou seja, usando o schemaLocation atributo) em um documento de esquema (ou seja, usando mecanismos de esquema import ) compartilharem o mesmo targetNamespace, o esquema especificado pelo usuário usando essa propriedade será usado. Se dois esquemas especificados usando essa propriedade compartilharem o mesmo targetNamespace ou não tiverem nenhum namespace, o comportamento dependerá da implementação. Se nenhum local tiver sido fornecido, esse parâmetro será null. <p ><b>Nota:/b> O "schema-location" parâmetro é ignorado,< a menos que o valor do parâmetro "schema-type" esteja definido. É altamente recomendável que Document.documentURI seja definido para que uma implementação possa resolver com êxito quaisquer entidades externas referenciadas. </dd><dt"schema-type"></dt<>dd>[<em>optional</em>] Representa um DOMString objeto que contém um URI absoluto e representa o tipo da linguagem de esquema usada para validar um documento. Observe que nenhuma verificação lexical é feita no URI absoluto. Se esse parâmetro não estiver definido, um valor padrão poderá ser fornecido pela implementação, com base nos idiomas de esquema suportados e na linguagem de esquema usada no tempo de carregamento. Se nenhum valor for fornecido, esse parâmetro será null. <p ><b>Nota:</b> Para Esquema XML [Esquema XML Parte 1] , os aplicativos devem usar o valor "http://www.w3.org/2001/XMLSchema". Para XML DTD [XML 1.0], os aplicativos devem usar o valor "http://www.w3.org/TR/REC-xml". Outras linguagens de esquema estão fora do escopo do W3C e, portanto, devem recomendar um URI absoluto para usar esse método. </dd>dt><"split-cdata-sections"/dt><dd<>dl<>dttrue></dt><dd>[<em>required</em>] (<em>default</em>)Dividir seções CDATA contendo o marcador de terminação de seção CDATA ']]>'.< Quando uma seção CDATA é dividida, um aviso é emitido com um DOMError.type igual a "cdata-sections-splitted" e DOMError.relatedData igual ao primeiro CDATASection nó na ordem do documento resultante da divisão.</dd><dt>false</dt<>dd>[<em>required</em>]Sinaliza um erro se a CDATASection contiver um caractere não representável.</dd></dl></dd><dt"validate"></dt<>dd<>dl><dt<true>/dt<>dd>[<em>optional</em>] Requer a validação em relação a um esquema (esquema i.e. XML, DTD, qualquer outro tipo ou representação de esquema) do documento conforme ele está sendo normalizado conforme definido por [XML 1.0]. Se forem encontrados erros de validação ou se nenhum esquema for encontrado, o manipulador de erros será notificado. Os valores normalizados pelo esquema não serão expostos de acordo com o esquema em uso, a menos que o parâmetro "datatype-normalization" seja true. Este parâmetro irá reavaliar: <ul<>li> Attribute nodes with Attr.specified equals to false, conforme especificado na descrição da Attr interface; </li><li> O valor do atributo Text.isElementContentWhitespace para todos os Text nós; </li><li> O valor do atributo Attr.isId para todos os Attr nós; </li><li> Os atributos Element.schemaTypeInfo e Attr.schemaTypeInfo. </li></ul<>p ><b>Nota:</b> "validate-if-schema" e "validate" são mutuamente exclusivos, definindo um deles para true definir o outro como false. Os aplicativos também devem considerar a definição do parâmetro "bem formado" como true, que é o padrão para essa opção, ao validar o documento. </dd>dt<false>/dt><dd>[<em>required</em>] (<em>default</em>) Não realize o processamento do esquema, incluindo o processamento do subconjunto interno.< As informações de valores de atributo padrão são mantidas. Observe que a validação ainda pode acontecer se "validate-if-schema" for true . </dd>/dl></dd<>dt>"validate-if-schema"</dt><dd<>dl<>dt<true>/dt<>dd>[<em>optional</em>]Habilite a validação somente se uma declaração para o elemento do documento puder ser encontrada em um esquema (independentemente de onde ele for encontrado, i.e. XML esquema, DTD ou qualquer outro tipo ou representação de esquema).< Se a validação estiver habilitada, esse parâmetro terá o mesmo comportamento que o parâmetro "validate" definido como true. <p ><b>Nota:</b> "validate-if-schema" e "validate" são mutuamente exclusivos, definindo um deles como true irá definir o outro como false. </dd>dt<false>/dt><dd>[<em>required</em>] (<em>default</em>) Nenhum processamento de esquema deve ser executado se o documento tiver um esquema, incluindo processamento de subconjunto interno.< As informações de valores de atributo padrão são mantidas. Observe que a validação ainda deve acontecer se "validar" for true. </dd></dl></dd<>dt<>"well-formed"/dt<>dd><dl<>dt>true</dt<>dd>[<em>required</em>] (<em>default</em>) Verifique se todos os nós são XML bem formados de acordo com a versão XML em uso emDocument.xmlVersion: <ul><li> Verifique se o atributo Node.nodeName contém caracteres inválidos de acordo com seu tipo de nó e gere um DOMError do tipo"wf-invalid-character-in-node-name", com uma DOMError.SEVERITY_ERROR gravidade, se necessário; </li><li> verificar se o conteúdo do texto dentro Attrde , Element, Comment, Text, nós CDATASection para caracteres inválidos e gerar um DOMError do tipo "wf-invalid-character", com uma DOMError.SEVERITY_ERROR severidade, se necessário; </li><li> verificar se os dados dentro ProcessingInstruction dos nós para caracteres inválidos e gerar um DOMError do tipo "wf-invalid-character", com uma DOMError.SEVERITY_ERROR severidade, se necessário; </li></ul></dd><dt<>false/dt<>dd>[<em>optional</em>] Não verifique se há XML bem formado. </dd></dl></dd></dl>
A resolução dos identificadores do sistema associados a entidades é feita usando Document.documentURIo . No entanto, quando o recurso "LS" definido em [DOM Level 3 Load and Save] é suportado pela implementação do DOM, o parâmetro "resource-resolver" também pode ser usado em DOMConfiguration objetos anexados a Document nós. Se esse parâmetro for definido, Document.normalizeDocument() invocará o resolvedor de recursos em vez de usar Document.documentURI.
Consulte também a Especificação principal de nível 3 do DOM (Document Object Model).
Adicionado no DOM Nível 3.
Documentação Java para org.w3c.dom.DOMConfiguration.
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.
Propriedades
| 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) |
| ParameterNames |
A lista dos parâmetros suportados por este |
| PeerReference |
Retorna uma JniObjectReference das instâncias do objeto Java encapsulado. (Herdado de IJavaPeerable) |
Métodos
| CanSetParameter(String, Object) |
Verifique se há suporte para a configuração de um parâmetro para um valor específico. |
| 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) |
| GetParameter(String) |
Retornar o valor de um parâmetro, se conhecido. |
| SetJniIdentityHashCode(Int32) |
Defina o valor retornado por |
| SetJniManagedPeerState(JniManagedPeerStates) |
A |
| SetParameter(String, Object) |
Defina o valor de um parâmetro. |
| 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) |
A |
| GetJniTypeName(IJavaPeerable) |
A |