DocumentBase.SelectNodes(String, String, Boolean) Metoda

Definicja

Przestrzeń nazw:

Microsoft.Office.Tools.Word

Zestaw:

Microsoft.Office.Tools.Word.v4.0.Utilities.dll

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

public Microsoft.Office.Interop.Word.XMLNodes SelectNodes (string xPath, string prefixMapping, bool fastSearchSkippingTextNodes);

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

Public Function SelectNodes (xPath As String, Optional prefixMapping As String, Optional fastSearchSkippingTextNodes As Boolean) As XMLNodes

Parametry

xPath

String

Prawidłowy ciąg XPath. Aby uzyskać więcej informacji na temat programu XPath, zobacz Dokumentacja 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 pomija wszystkie węzły tekstowe podczas wyszukiwania określonego węzła. false zawiera węzły tekstowe w wyszukiwaniu. Wartość domyślna to false.

Zwraca

XMLNodes

XMLNodes Kolekcja reprezentująca wszystkie węzły zgodne z parametrem XPath w kolejności, w której są wyświetlane w dokumencie; null jeśli nie zostaną znalezione żadne węzły zgodne z parametremXPath.

Przykłady

Poniższy przykład kodu przedstawia sposób określania XPath parametrów i PrefixMapping podczas wywoływania SelectNodes metody . Aby użyć tego przykładu ThisDocument , uruchom go z klasy w projekcie na poziomie dokumentu.

private void DocumentSelectNodes()
{
    if (this.XMLSchemaReferences.Count > 0)
    {
        string XPath = "/x:catalog/x:book/x:title";
        object key = 1;
        string PrefixMapping = "xmlns:x=\"" +
            this.XMLSchemaReferences[key].NamespaceURI +
            "\"";
        Word.XMLNodes nodes = this.SelectNodes(XPath, 
            PrefixMapping, true);
    }
    else
    {
        MessageBox.Show("The document does not contain a " +
            "schema reference.");
    }
}

Private Sub DocumentSelectNodes()
    If Me.XMLSchemaReferences.Count > 0 Then
        Dim XPath As String = "/x:catalog/x:book/x:title"
        Dim PrefixMapping As String = "xmlns:x=""" + _
            Me.XMLSchemaReferences(1).NamespaceURI + """"
        Dim node As Word.XMLNodes = Me.SelectNodes(XPath, _
            PrefixMapping, True)
    Else
        MessageBox.Show("The document does not contain a " + _
            "schema reference.")
    End If
End Sub

Uwagi

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

Parametry opcjonalne

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