DOMDocument
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Representa o parte superior nível da código-fonte XML. Inclui os membros para recuperar e criando todos os outros objetos XML.
Métodos
A seguinte tabela mostra os métodos para DOMDocument.
| Método | Descrição |
|---|---|
Anula um assíncrono baixar em andamento. |
|
Acrescenta newChild Como o último filho neste nó. |
|
Cria um novo nó que é um clone exato neste nó. |
|
Cria um novo atributo com o nome especificado. |
|
Cria um nó seção CDATA que contém os dados fornecidos. |
|
Cria um nó comentar que contém os dados fornecidos. |
|
Cria um vazio IXMLDOMDocumentFragment WScript.Shell. |
|
Cria um nó elemento usando o nome especificado. |
|
Cria um novo IXMLDOMEntityReference WScript.Shell. |
|
Cria um nó usando o tipo fornecido, Nome e espaço para nome. |
|
Cria um nó instrução de processamento que contém o destino fornecido e dados. |
|
Cria um nó de texto que contém os dados fornecidos. |
|
Retorna uma coleção de elementos que possuem o nome especificado. |
|
Retorna VERDADEIRO se este nó tem filhos. |
|
Insere um nó filho para a esquerda do nó especificado ou no final de lista. |
|
Carrega um documento XML da localidade especificada. |
|
Carrega um documento XML usando o seqüência de caracteres fornecido. |
|
Retorna o nó cujo atributo identificador coincide com o valor fornecido. |
|
Remove a lista de filhos a nó filho especificado e retorna-lo. |
|
Substitui o nó filho antigo especificado com o nó filho novo fornecido no conjunto de filhos neste nó e retorna o nó filho antigo. |
|
Salva um documento XML para a localidade especificada. |
|
Aplica o padrão especificado-compatível operação ao contexto neste nó e retorna a lista de compatível nós. |
|
Aplica o padrão especificado-compatível operação para contexto e retorna o primeiro compatível do este nó nó. |
|
Processa esse nó e seus filhos usando a folha estilo Extensible Stylesheet Language Transformations (XSLT) fornecida e retorna a transformação resultante. |
|
Processa esse nó e seus filhos usando o folha de estilo XSLT fornecidas e retorna a transformação resultante no objeto fornecido. |
* indica uma extensão para o W3C DOM.
Propriedades
A seguinte tabela mostra as propriedades para DOMDocument.
| Propriedade | Descrição |
|---|---|
Indica se assíncrono baixar é permitido. Leitura/gravação. |
|
Contém a lista de atributos para esse nó. Somente leitura. |
|
Retorna o nome de base para o nome qualificado com o espaço para nome. Somente leitura. |
|
Contém uma lista nó que contém os filhos (para nós que podem ter filhos). Somente leitura. |
|
Especifica o tipo de dados para esse nó. Leitura/gravação. |
|
Retorna a definição do nó do esquema ou documento tipo definição (DTD Document Type DEFINITION). Somente leitura. |
|
Contém o nó tipo documento que especifica o DTD para este documento. Somente leitura. |
|
Contém o elemento raiz do documento. Leitura/gravação. |
|
Contém o primeiro filho neste nó. Somente leitura. |
|
Contém o IXMLDOMImplementation objeto para esse documento. Somente leitura. |
|
Retorna o último nó filho. Somente leitura. |
|
Retorna a URI (Uniform Resource Identifier) (URI) para o espaço para nome. Somente leitura. |
|
Contém o próximo irmão desse nó na lista filho do pai. Somente leitura. |
|
Contém a nome qualificado do elemento, atributo, ou referência de entidade ou um seqüência de caracteres fixo para outros tipos nó. Somente leitura. |
|
Especifica o tipo de nó XML Document Object Model (DOM), que determina válido valores e se o nó pode ter nós filho. Somente leitura. |
|
Contém valor deste nó, expresso em seu tipo de dados definido. Leitura/gravação. |
|
Retorna o tipo de nó na forma seqüência de caracteres. Somente leitura. |
|
Contém o texto associado com o nó. Leitura/gravação. |
|
Especifica o manipulador de eventos para a ondataavailable evento. Leitura/gravação. |
|
Especifica o manipulador de eventos ser chamado quando o ReadyState propriedade alterações. Leitura/gravação. |
|
Especifica o manipulador de eventos para a onTransformNode evento. Leitura/gravação. |
|
Retorna a raiz do documento que contém esse nó. Somente leitura. |
|
Contém o nó pai (para nós que podem ter pais). Somente leitura. |
|
Contém verdadeiro se este nó e todos os descendentes tiverem sido analisados e instanciado; Nós falsos se qualquer permanecem para ser analisada. Somente leitura. |
|
Retorna um IXMLDOMParseError objeto que contém informações sobre a análise último erro. Somente leitura. |
|
Retorna o prefixo do espaço para nome. Somente leitura. |
|
Contém verdadeiro se usar como padrão processamento preserva espaço em branco; Caso contrário False. Leitura/gravação. |
|
Contém o irmão à esquerda neste nó. Somente leitura. |
|
Indica o atual estado da documento XML. Somente leitura. |
|
Indica se externo definições (resolvível espaços para nome, o DTD externo subconjuntos e externo referências entidade) devem ser resolvidos no tempo de análise, independente da validação. Leitura/gravação. |
|
Indica se o nó (normalmente um atributo) é explicitamente especificada ou derivado de um valor usar como padrão no DTD ou esquema. Somente leitura. |
|
Contém o de conteúdo de texto de suas subárvores e o nó. Leitura/gravação. |
|
URL* |
Retorna o URL canonicalized para a última carregado documento XML. Somente leitura. |
Indica se o analisador deve validar esse documento. Leitura/gravação. |
|
XML* |
Contém a representação XML do nó e todos os seus descendentes. Somente leitura. |
* indica uma extensão para o DOM. W3C (World Wide Web Consortium) (W3C (World Wide Web Consortium))
Eventos
A seguinte tabela mostra os eventos para DOMDocument.
| Evento | Descrição |
|---|---|
Indica que documento XML dados está disponível. |
|
Indica quando o ReadyState propriedade alterações. |
|
Acionado antes cada nó na folha de estilo é aplicado a cada nó na código-fonte XML. O onTransformNode evento não acionar em DOMDocument Para planilhas estilo usando o espaço para nome XSLT. Possuir, no entanto, acionar em DOMDocument Para planilhas estilo usando o espaço para nome XSL. |
* indica uma extensão para o W3C DOM.
Remarks
DOMDocument Representa o parte superior nó na árvore. Ele implementa todos os métodos documento DOM (Document Object Model) de base e fornece membros adicionais que suporte as transformações Extensible Stylesheet Language (XSL) e XML.
Somente um objeto pode ser criado: o documento. Todos os outros objetos são acessados ou criados a partir de documento.
O documento pode ser criado usando um modelo rental-threaded. O documento-modelo de segmento é definido pelas seguinte configurações.
| Configuração | Modelo Rental-threaded |
|---|---|
Versão independente ProgID |
MSXML2.DOMDocument |
ProgID |
MSXML2.DOMDocument.3.0 |
ClassID |
F6D90F11-9 C D 73-11 3-B32E-00C04F990BB4 |
Nome de classe VB |
DOMDocument30 |
Juntamente com as interfaces DOM, DOMDocument Implementa um número de padrão interfaces COM. Você pode chamar o Falha de QueryInterface método Logon DOMDocument Para o seguinte get interfaces.
| Interface | O uso |
|---|---|
IUnknown |
DOMDocument é um objeto wrapper e cada consulta para DOMDocument Retorna um novo wrapper. Você só deve comparar IUnknown Ponteiros interface. |
IConnectionPointContainer |
Oferece suporte a de saída eventos Evento ondataavailable e onreadystatechange de eventos Por meio IPropertyNotifySink::OnChanged e IDispatch::Invoke. |
IDispatch |
Interface usado pelo Visual Basic. |
IDispatchEx |
Interface usada pelo dinâmico atrasado-ligado linguagens de script como sistema desenvolvimento Microsoft JScript® e Microsoft® Visual Basic® Scripting Edition (VBScript). Isso não é totalmente implementado. O seguinte métodos sempre retornam E_NOTIMPL: DeleteMemberByName Ou DeleteMemberByDispID, GetMemberProperties, GetMemberName, GetNextDispID, e GetNameSpaceParent. |
IObjectSafety |
Quando o SetInterfaceSafetyOptions método é chamado com diferente de zero as opções de segurança, o Microsoft XML Parser (MSXML) irá aplicar regras de segurança antes buscando dados XML. |
IObjectWithSite |
Permite que um aplicativo hospedar para fornecer adicional contextual informações, tais a URL básico. |
IOleCommandTarget |
Usado por um contêiner COM para enviar um comando OLECMDID_STOP para parar um assíncrono baixar. |
IPersistMoniker |
Fornece controle sobre como BIND o documento XML para dados persistentes. O síncrono e assíncrono carregando estiver usando com suporte BindToStorage Sobre a determinado IMoniker. Salvar Não é chamado; Portanto, o BindToStorage, IsDirty, e SaveCompleted métodos retornam E_NOTIMPL. |
IPersistStream |
Usado para salvar e carregar o documento XML para e de um IStream. |
IPersistStreamInit |
Versão Atualizada do IPersistStream. |
IProvideClassInfo |
Fornece uma maneira fácil get ITypeInfo Para o DOMDocument. |
IStream |
Você pode ler e gravação diretamente para o documento através de IStream que é retornado. Não é possível Busca Durante uma Gravar operação e a seguinte métodos não são implementados neste transmitir: SetSize, CopyTo, Confirmar, Reverter, LockRegion, UnlockRegion, e Clone. Isso permite que você compilar um documento XML de forma eficiente por fornecer blocos de XML e chamado Gravar Sobre a transmitir. Você também pode usar esta opção para testar a persistência da sua atual documento DOM, chamado "xmldoc1.Save(xmldoc2)." O Salvar método usa esse IStream interface. |
Quando os métodos do objeto de criação, como createElement, são usados no documento, nós são criadas no contexto do documento, o omo mas o nó não é parte da árvore de documento. O nó é apenas uma parte da árvore de documento quando ele estiver explicitamente adicionada à árvore por chamado insertBefore, replaceChild, ou appendChild; ou Para atributos, usando setAttributeNode).
Essa interface herda IXMLDOMNode.
Requisitos
| Header | msxml2.h, msxml2.idl |
| Windows Embedded CE | Windows CE .NET 4.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
See Also
Reference
Concepts
ondataavailable Event
onreadystatechange Event
appendChild Method
createElement Method
insertBefore Method
replaceChild Method
setAttributeNode Method
ownerDocument Property