XMLNode.SelectNodes(String, String, Boolean) Metoda

Definicja

Przestrzeń nazw:

Microsoft.Office.Tools.Word

Zestaw:

Microsoft.Office.Tools.Word.dll

Pobiera kolekcję reprezentującą XMLNodes wszystkie węzły zgodne z XPath parametrem w kolejności, w której są wyświetlane w kontrolce XMLNode .

public Microsoft.Office.Interop.Word.XMLNodes SelectNodes (string XPath, string PrefixMapping = "", bool FastSearchSkippingTextNodes = true);

abstract member SelectNodes : string * string * bool -> Microsoft.Office.Interop.Word.XMLNodes

Public Function SelectNodes (XPath As String, Optional PrefixMapping As String = "", Optional FastSearchSkippingTextNodes As Boolean = true) As XMLNodes

Parametry

XPath

String

Prawidłowy ciąg XPath.

PrefixMapping

String

Zawiera prefiks w schemacie, za pomocą którego przeprowadza się wyszukiwanie. Użyj parametru PrefixMapping , jeśli XPath parametr używa nazw do wyszukiwania elementów.

FastSearchSkippingTextNodes

Boolean

true aby pominąć wszystkie węzły tekstowe podczas wyszukiwania określonego węzła. false w celu uwzględnienia węzłów tekstowych w wyszukiwaniu. Wartość domyślna to false.

Zwraca

XMLNodes

Węzły pasujące do parametru XPath w kolejności, w której są wyświetlane w kontrolce XMLNode .

Przykłady

Poniższy przykład kodu używa SelectNodes metody do pobrania kolekcji węzłów podrzędnych pasujących do danego XPath parametru. W przykładzie zostanie wyświetlona liczba znalezionych węzłów. W tym przykładzie przyjęto założenie, że bieżący dokument zawiera XMLNode nazwę o nazwie CustomerNode z pasującym elementem schematu zawierającym co najmniej jeden węzeł podrzędny o nazwie 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

Uwagi

Ustawienie parametru FastSearchSkippingTextNodes w celu false zmniejszenia wydajności, ponieważ pakiet Microsoft Office Word przeszukuje wszystkie węzły w dokumencie dla tekstu zawartego w węźle.

Parametry opcjonalne

Aby uzyskać informacje na temat parametrów opcjonalnych, zobacz Parametry opcjonalne w rozwiązaniach pakietu Office.