DocumentBase.SelectSingleNode(String, String, Boolean) Metoda

Definicja

Przestrzeń nazw:

Microsoft.Office.Tools.Word

Zestaw:

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

XMLNode Zwraca obiekt reprezentujący pierwszy węzeł w dokumencie zgodny z parametrem XPath .

public Microsoft.Office.Interop.Word.XMLNode SelectSingleNode (string xPath, string prefixMapping, bool fastSearchSkippingTextNodes);

member this.SelectSingleNode : string * string * bool -> Microsoft.Office.Interop.Word.XMLNode

Public Function SelectSingleNode (xPath As String, Optional prefixMapping As String, Optional fastSearchSkippingTextNodes As Boolean) As XMLNode

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

XMLNode

XMLNode Obiekt reprezentujący pierwszy węzeł zgodny z parametrem XPath w dokumencie; null jeśli nie zostaną znalezione żadne węzły pasujące do parametruXPath.

Przykłady

W poniższym przykładzie kodu pokazano, jak określić XPath parametry i PrefixMapping podczas wywoływania SelectSingleNode metody . Aby użyć tego przykładu ThisDocument , uruchom go z klasy w projekcie na poziomie dokumentu.

private void DocumentSelectSingleNode()
{
    if (this.XMLSchemaReferences.Count > 0)
    {
        string XPath = "/x:catalog/x:book/x:title";
        object key = 1;

        string PrefixMapping = "xmlns:x=\"" +
            this.XMLSchemaReferences.get_Item(ref key).NamespaceURI +
            "\"";

        Word.XMLNode node = this.SelectSingleNode(XPath, 
            PrefixMapping, true);
    }
    else
    {
        MessageBox.Show("The document does not contain a " +
            "schema reference.");
    }
}

Private Sub DocumentSelectSingleNode()
    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.XMLNode = Me.SelectSingleNode(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.