Share via


Propriedade Document.SolutionXMLElement (Visio)

Contém dados XML bem formados, específicos da solução armazenados com um documento. Leitura/gravação.

Sintaxe

expressão. SolutionXMLElement (ElementName)

Expressão Uma variável que representa um objeto Document .

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Elementname Obrigatório String O nome que diferencia maiúsculas de minúsculas do elemento de dados SolutionXML.

Valor de retorno

Cadeia de caracteres

Comentários

O valor de ElementName deve corresponder ao valor do atributo Name do elemento SolutionXML. Por exemplo, se os dados XML de uma solução começaram com a instrução <SolutionXML Name='somename'>, use o ElementName "somename" para recuperar esses dados.

  • Se ElementName já existe, a propriedade SolutionXMLElement sobrescreve dados XML existentes. Use a propriedade SolutionXMLElementExists antes de gravar dados XML para evitar a perda de dados unintentionally.

  • Se ElementName não existe, a propriedade SolutionXMLElement cria um elemento por aquele nome.

Como seus dados XML são validados quando você os grava, você irá normalmente executar essa operação durante um evento DocumentSaved por razões de execução.

No nível do documento, se os dados XML passados para a propriedade SolutionXMLElement estiverem bem formados e contiverem um esquema válido e uma declaração de namespace, eles serão salvos como XML aninhado, no formato de arquivo VDX do Microsoft Visio. Se você passar dados XML inválidos, o Visio converterá esses dados em um comentário XML para que os dados não sejam perdidos. No entanto, se você carregar posteriormente o arquivo VDX salvo que contém o comentário no Visio, o comentário XML será ignorado e, consequentemente, os dados serão perdidos.

Se você colocar dados XML inválidos ou que não estejam bem formados em uma célula, o Visio os salvará como uma cadeia de caracteres na célula para que não sejam perdidos e possam talvez mais tarde serem corrigidos.

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.