XMLNode.SelectNodes – metoda

Článek
05/14/2013

Získá Microsoft.Office.Interop.Word.XMLNodes kolekci, která představuje všechny uzly, které odpovídají XPath parametr v pořadí, v jakém jsou uvedeny v Microsoft.Office.Tools.Word.XMLNode ovládacího prvku.

Obor názvů: Microsoft.Office.Tools.Word
Sestavení: Microsoft.Office.Tools.Word (v Microsoft.Office.Tools.Word.dll)

Syntaxe

'Deklarace
Function SelectNodes ( _
    XPath As String, _
    PrefixMapping As String, _
    FastSearchSkippingTextNodes As Boolean _
) As XMLNodes

XMLNodes SelectNodes(
    string XPath,
    string PrefixMapping,
    bool FastSearchSkippingTextNodes
)

Parametry

XPath
Typ: System.String
Platný řetězec výraz XPath.

PrefixMapping
Typ: System.String
Poskytuje předponu ve schématu, proti kterému chcete-li provést hledání.Použití PrefixMapping parametr-li vaše XPath parametr používá názvy hledání prvků.

FastSearchSkippingTextNodes
Typ: System.Boolean
true Chcete-li přeskočit všechny textové uzly při hledání pro zadaný uzel. false Chcete-li při hledání zahrnout textové uzly.Výchozí hodnota je false.

Vrácená hodnota

Typ: Microsoft.Office.Interop.Word.XMLNodes
Uzlů, které odpovídají XPath parametr v pořadí, v jakém jsou uvedeny v Microsoft.Office.Tools.Word.XMLNode ovládacího prvku.

Poznámky

Nastavení FastSearchSkippingTextNodes parametr false nesnižuje výkon, protože aplikace Microsoft Office Word vyhledá všechny uzly v dokumentu text obsažený v uzlu.

Volitelné parametry

Informace o volitelných parametrů naleznete v tématu Volitelné parametry v Office Solutions.

Příklady

Následující příklad kódu používá SelectNodes metodu pro získání kolekce podřízených uzlů, které odpovídají daném XPath parametr.Příkladu se potom zobrazí počet uzlů, které nebyly nalezeny.Tento příklad předpokládá, že obsahuje aktuální dokument XMLNode s názvem CustomerNode s odpovídající prvek schématu, který obsahuje jeden nebo více podřízených uzlů s názvem FirstName.

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

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.");
}

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.

Viz také

Referenční dokumentace

XMLNode Rozhraní

Microsoft.Office.Tools.Word – obor názvů

Sdílet prostřednictvím