XMLNode.SelectNodes(String, String, Boolean) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
public Microsoft.Office.Interop.Word.XMLNodes SelectNodes (string XPath, string PrefixMapping = "", bool FastSearchSkippingTextNodes = true);
Parameter
- XPath
- String
Eine gültige XPath-Zeichenfolge.
- PrefixMapping
- String
Stellt das Präfix im Schema bereit, das bei der Suche verwendet wird. Verwenden Sie den PrefixMapping-Parameter, wenn Ihr XPath-Parameter Namen für die Suche nach Elementen verwendet.
- FastSearchSkippingTextNodes
- Boolean
true, wenn bei der Suche nach dem angegebenen Knoten alle Textknoten übersprungen werden sollen. false, um Textknoten in die Suche einzubeziehen. Der Standardwert ist falsesein.
Gibt zurück
Die mit dem XPath-Parameter übereinstimmenden Knoten in der Reihenfolge, in der sie im XMLNode-Steuerelement angeordnet sind.
Beispiele
Im folgenden Codebeispiel wird die- SelectNodes Methode verwendet, um eine Auflistung der untergeordneten Knoten zu erhalten, die dem angegebenen- XPath Parameter entsprechen. Im Beispiel wird dann die Anzahl der gefundenen Knoten angezeigt. In diesem Beispiel wird davon ausgegangen, dass das aktuelle Dokument einen XMLNode mit dem Namen CustomerNode mit einem übereinstimmenden Schema Element enthält, das mindestens einen untergeordneten Knoten namens enthält FirstName .
private void DisplayFirstNameNodesCount()
{
string element = "/x:Customer/x:FirstName";
string prefix = "xmlns:x='" +
this.CustomerFirstNameNode.NamespaceURI + "'";
Word.XMLNodes nodes = this.CustomerNode.SelectNodes(element,
prefix, true);
MessageBox.Show(nodes.Count + " element(s) were found.");
}
Private Sub DisplayFirstNameNodesCount()
Dim element As String = "/x:Customer/x:FirstName"
Dim prefix As String = "xmlns:x='" & _
Me.CustomerFirstNameNode.NamespaceURI & "'"
Dim nodes As Word.XMLNodes = _
Me.CustomerNode.SelectNodes(element, prefix, True)
MsgBox(nodes.Count & " element(s) were found.")
End Sub
Hinweise
FastSearchSkippingTextNodesWenn Sie den-Parameter auf festlegen false , wird die Leistung verringert, da Microsoft Office Word alle Knoten in einem Dokument nach dem im Knoten enthaltenen Text durchsucht.
Optionale Parameter
Weitere Informationen zu optionalen Parametern finden Sie unter optionale Parameter in Office-Projektmappen.