Freigeben über

Document.SolutionXMLElement-Eigenschaft (Visio)

  • Artikel

Enthält lösungsspezifische, wohlgeformte XML-Daten,die mit einem Dokument gespeichert werden. Lese-/Schreibzugriff.

Syntax

Ausdruck. SolutionXMLElement (ElementName)

Ausdruck Eine Variable, die ein Document-Objekt darstellt.

Parameter

Name Erforderlich/Optional Datentyp Beschreibung
ElementName Erforderlich String Der Name des SolutionXML-Datenelements. Bei der Angabe des Namens wird die Groß-/Kleinschreibung berücksichtigt.

Rückgabewert

String

Hinweise

Der Wert des Arguments ElementName muss mit dem Wert des Attributs für den Namen des SolutionXML-Elements übereinstimmen. Wenn die XML-Daten einer Lösung beispielsweise mit der Anweisung <SolutionXML Name='somename'> beginnen, verwenden Sie den ElementName "somename", um diese Daten abzurufen.

  • Ist das Argument ElementName bereits vorhanden, überschreibt die SolutionXMLElement-Eigenschaft vorhandene XML-Daten. Verwenden Sie die SolutionXMLElementExists-Eigenschaft, bevor Sie XML-Daten schreiben, um unbeabsichtigten Datenverlust zu vermeiden.

  • Ist das Argument ElementName nicht vorhanden, erstellt die SolutionXMLElement-Eigenschaft ein Element gemäß dem Namen.

Da Ihre XML-Daten beim Schreiben der Daten überprüft werden, wird dieser Vorgang zur Vermeidung von Leistungseinbußen in der Regel während eines DocumentSaved-Ereignisses durchgeführt.

Auf der Dokumentebene werden die an die SolutionXMLElement-Eigenschaft übergegebenen XML-Daten als geschachteltes XML-Element im VDX-Dateiformat von Microsoft Visio gespeichert, wenn die Daten wohlgeformt sind und eine gültige Schema-Namespacedeklaration enthalten. Wenn Sie ungültige XML-Daten übergeben, konvertiert Visio diese Daten in einen XML-Kommentar, damit die Daten nicht verloren gehen. Wenn Sie jedoch anschließend die gespeicherte VDX-Datei, die den Kommentar enthält, in Visio laden, wird der XML-Kommentar ignoriert, und folglich gehen die Daten verloren.

Wenn Sie ungültige und nicht wohlgeformte XML-Daten in eine Zelle eingeben, werden diese in Visio als eine Zeichenfolge in der Zelle gespeichert, sodass die Daten nicht verloren gehen und eventuell zu einem späteren Zeitpunkt korrigiert werden können.

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.