Get-ValueByNode

EulandaXtools — Funktionsreferenz

Get-ValueByNode

ÜBERSICHT

Gibt den Textinhalt eines XML-Knotens zurück, der über einen XPath-Ausdruck selektiert wird.

SYNTAX

Get-ValueByNode [[-Xml] <System.Xml.XmlNode>] [[-Xpath] <string>] [<CommonParameters>]

BESCHREIBUNG

Diese Funktion ermittelt den Textinhalt ('InnerText') eines XML-Elements oder XML-Dokuments, der mit einem angegebenen XPath-Ausdruck ausgewählt wird. Falls der angegebene Knoten nicht existiert oder leer ist, wird '$null' zurückgegeben.

PARAMETER

-Xml

Type: System.Xml.XmlNode

Ein XML-Dokument oder XML-Element vom Typ '[System.Xml.XmlNode]'.

-Xpath

Type: string

XPath-Ausdruck zur gezielten Auswahl des gewünschten XML-Knotens.

AUSGABEN

string

Gibt den 'InnerText' des Knotens zurück oder '$null', falls der Knoten fehlt oder leer ist.

BEISPIELE

# Gibt zurück: "Max Mustermann"
$doc = [Xml]'<Root><User><Name>Max Mustermann</Name></User></Root>'
Get-ValueByNode -Xml $doc -Xpath '/Root/User/Name'
# Nutzung relativ zu einem Teilbaum
$node = $doc.SelectSingleNode('/Root/User')
Get-ValueByNode -Xml $node -Xpath 'Name'