Worksheet.XmlDataQuery-Methode (Excel)

  • Artikel

Gibt ein Range-Objekt zurück, das die Zellen darstellt, die einem bestimmten XPath zugeordnet sind. Gibt Nothing zurück, wenn der angegebene XPath dem Arbeitsblatt nicht zugeordnet wurde oder wenn der zugeordnete Bereich leer ist.

Syntax

Ausdruck. XmlDataQuery (XPath, SelectionNamespaces, Map)

Ausdruck: Eine Variable, die ein Worksheet-Objekt darstellt.

Parameter

Name Erforderlich/Optional Datentyp Beschreibung
XPath Erforderlich String Der abzufragende XPath.
SelectionNamespaces Optional Variant Ein durch Leerzeichen getrennter String-Wert, der die Namespaces enthält, auf die im XPath-Parameter verwiesen wird. Wenn einer der angegebenen Namespaces nicht aufgelöst werden kann, wird ein Laufzeitfehler generiert.
Map Optional Variant Geben Sie eine XmlMap an, wenn Sie den XPath innerhalb einer bestimmten Zuordnung abfragen möchten.

Rückgabewert

Range

HinwBemerkungeneise

Wenn sich der XPath in einer Spalte einer XML-Liste befindet, ist die Überschrift im zurückgegebenen Range-Objekt nicht enthalten.

Diese Methode gibt Nothing zurück, wenn der Pfad des XPath-Speicherorts der Tabelle nicht zugeordnet ist. Wenn Nothing zurückgegeben wird, bedeutet dies nicht unbedingt, dass die Zuordnung nicht vorhanden ist. Es könnte auch bedeuten, dass am angegebenen XPath-Speicherort derzeit kein Datenbereich verfügbar ist. Verwenden Sie die XmlMapQuery-Methode , um zu überprüfen, ob ein zugeordneter XPath vorhanden ist.

Hinweis

Mit der XmlDataQuery-Methode können Sie das Vorhandensein bestimmter Kartendaten abfragen. Es kann nicht verwendet werden, um daten in einer Karte abzufragen.

Beispielsweise ist es gültig, dass ein zugeordneter Bereich vorhanden ist, in dem der XPath für diesen Bereich ist "/root/People[@Age="23"]/FirstName". Eine XmlDataQuery-Abfrage für diesen XPath-Speicherortpfad gibt den richtigen Bereich zurück. Eine Abfrage für "/root/People[FirstName="Joe"]" die Hoffnung, "Joe" innerhalb des oben zugeordneten Bereichs zu finden, schlägt jedoch fehl, da die XPath-Definitionen für die zugeordneten Bereiche unterschiedlich sind.

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.