XMLNode.SelectSingleNode(String, String, Boolean) Metoda

Definicja

Przestrzeń nazw:

Microsoft.Office.Tools.Word

Zestaw:

Microsoft.Office.Tools.Word.dll

XMLNode Pobiera obiekt reprezentujący pierwszy węzeł podrzędny zgodny z parametrem XPath w kontrolceXMLNode.

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

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

Public Function SelectSingleNode (XPath As String, Optional PrefixMapping As String = "", Optional FastSearchSkippingTextNodes As Boolean = true) As XMLNode

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 aby uwzględnić węzły tekstowe w wyszukiwaniu. Wartość domyślna to true.

Zwraca

XMLNode

Pierwszy węzeł podrzędny zgodny z parametrem XPath w kontrolce XMLNode .

Przykłady

W poniższym przykładzie kodu użyto SelectSingleNode metody w celu pobrania węzła podrzędnego zgodnego z danym XPath parametrem. W przykładzie zostanie wyświetlona nazwa znalezionego węzła. 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 LastName.

private void FindLastNameNode()
{
    string element = "/x:Customer/x:LastName";
    string prefix = "xmlns:x='" + 
        this.CustomerLastNameNode.NamespaceURI + "'";

    Word.XMLNode node = this.CustomerNode.SelectSingleNode(element,
        prefix, true);
    if (node != null)
    {
        MessageBox.Show(node.BaseName + " element was found.");
    }
    else
    {
        MessageBox.Show("The requested node was not found.");
    }
}

Private Sub FindLastNameNode()
    Dim element As String = "/x:Customer/x:LastName"
    Dim prefix As String = "xmlns:x='" & _
        Me.CustomerLastNameNode.NamespaceURI & "'"

    Dim node As Word.XMLNode = _
        Me.CustomerNode.SelectSingleNode(element, prefix, True)
    If node IsNot Nothing Then
        MsgBox(node.BaseName & " element was found.")
    Else
        MsgBox("The requested node was not found.")
    End If
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.