Compartilhar via

save Method

  • Artigo

Windows Mobile SupportedWindows Embedded CE Supported

9/8/2008

Salva um documento XML para a localidade especificada.

Sintaxe de script

oXMLDOMDocument.save(destination);

Comentários

Parâmetros de script

  • destino
    Objeto. O objeto pode representar um nome arquivo, um ASP Resposta objeto, um DOMDocument objeto, ou um personalizado objeto que ofereça suporte a persistência. Consulte os Comentários Gerais.

Valor Return script

Nenhum.

C/sintaxe C++

HRESULT save(
  VARIANT destination
);

Comentários

C/parâmetros C++

  • destino
    [no] Tipo de objeto para salvar. Esse objeto pode representar um nome arquivo, um ASP Resposta objeto, um objeto documento XML ou um personalizado objeto que ofereça suporte a persistência. Consulte " Comentários ".

C/valores Return C++

  • S_OK
    Valor retornado se bem-sucedido.
  • XML_BAD_ENCODING
    O documento contém um caractere que não pertence na codificação especificada. O caractere deve usar um referência de entidade numérico. De exemplo, o caractere Japanese Unicode 20013 não é adequado para a codificação Windows-1250 (o Alfabeto da Europa Central) e, portanto, deve ser representado na marcação como a referência de entidade numérico 中 Ou 中. Esta versão do salvar Não Não automaticamente converter caracteres para referências de entidade numérica.
  • E_INVALIDARG
    Foi fornecido um seqüência de caracteres, mas não é um válido nome arquivo.
  • E_ACCESSDENIED
    Salvar operação não é permitida.
  • E_OUTOFMEMORY
    Salvar deve alocar buffers.
  • (Outros valores)
    Qualquer outro erro sistema de arquivos pode ser retornado na salvar(seqüência de caracteres) maiúsculas e minúsculas.

Requisitos

Header msxml2.h, msxml2.idl
Library uuid.lib
Windows Embedded CE Windows CE .NET 4.0 and later

Comentários Gerais

O comportamento difere dependendo o objeto especificado pela objTarget parâmetro.

Objeto Descrição

Seqüência de caracteres

Especifica o nome arquivo. Observe que isso deve ser um nome arquivo vez um URL. O arquivo é criado se necessário e o conteúdo é totalmente substituído pelo conteúdo do documento salvo. Esse modo não se destina o uso de um Seguro cliente such as Microsoft® Internet Explorer.

    dim xmldoc
    set xmldoc = Server.CreateObject("Msxml2.DOMDocument")
    xmldoc.load("c:\myfile.xml")
    xmldoc.save(Server.MapPath("sample.xml"))

O Active Server Pages (ASP) Resposta objeto envia o documento voltar para o cliente que chamado o script ASP.

    dim xmldoc
    set xmldoc = Server.CreateObject("Msxml2.DOMDocument")
    xmldoc.load(Server.MapPath("sample.xml"))
    xmldoc.save(Response)

IXMLDocument Objeto

Duplica o original documento. Ele é o equivalente de salvar o documento e reparsing-la. O documento passa persistência completa através de marcação XML, assim, testes de persistability de seu documento XML.

Objeto personalizado suporte persistência

Quaisquer outro personalizado objeto COM que ofereça suporte a Falha de QueryInterface Para IStream, IPersistStream, ou IPersistStreamInit Também pode ser fornecido aqui, e o documento será salvo de acordo. In a IStream maiúsculas e minúsculas, o Gravação IStream método será chamado como ele salva o documento; in a IPersistStream maiúsculas e minúsculas, Carga IPersistStream será chamado com um IStream que ofereça suporte a Leitura, Busca, e STAT Métodos.

Referências externas entidade em declarações DOCTYPE, ENTITY, Notation e namespace para XML não são alteradas; Eles apontar para o original documento. Um documento XML salvo pode não carregar se as URLs não estiver acessível a partir de localidade na qual você salvou o documento.

Codificação de caracteres se baseia a codificação atributo no declaração XML, como <? XML versão = "1.0" codificação = "windows-1252"? >. Quando nenhuma codificação atributo for especificado, o configuração padrão é UTF-8.

Validação não é executada durante salvar, que pode resultar em um inválido documento que não carregar novamente because of uma definição tipo documento especificado (DTD Document Type DEFINITION). Esse membro é uma extensão de Document Object Model (DOM) de W3C (World Wide Web Consortium) (W3C (World Wide Web Consortium)).

Este método se aplica à seguinte interface:

DOMDocument.