Udostępnij za pośrednictwem

Metoda XMLNode.SelectSingleNode —

  • Artykuł

Pobiera Microsoft.Office.Interop.Word.XMLNode obiekt, który reprezentuje pierwszy węzeł podrzędny, który pasuje do XPath parametr w Microsoft.Office.Tools.Word.XMLNode kontroli.

Przestrzeń nazw:  Microsoft.Office.Tools.Word
Zestaw:  Microsoft.Office.Tools.Word (w Microsoft.Office.Tools.Word.dll)

Składnia

'Deklaracja
Function SelectSingleNode ( _
    XPath As String, _
    PrefixMapping As String, _
    FastSearchSkippingTextNodes As Boolean _
) As XMLNode

XMLNode SelectSingleNode(
    string XPath,
    string PrefixMapping,
    bool FastSearchSkippingTextNodes
)

Parametry

  • PrefixMapping
    Typ: System.String
    Zawiera prefiks w schemacie, za pomocą którego przeprowadza się wyszukiwanie.Użyj parametru PrefixMapping, jeśli parametr XPath używa nazw do wyszukania elementów.
  • FastSearchSkippingTextNodes
    Typ: System.Boolean
    true Aby pominąć wszystkie węzły tekstu podczas wyszukiwania określonego węzła. false Aby dołączyć tekst węzłów w wyszukiwaniu.Wartością domyślną jest true.

Wartość zwracana

Typ: Microsoft.Office.Interop.Word.XMLNode
Pierwszy węzeł podrzędny, który pasuje do XPath parametr w Microsoft.Office.Tools.Word.XMLNode kontroli.

Uwagi

Ustawienie FastSearchSkippingTextNodes parametru do false zmniejsza wydajność, ponieważ program Microsoft Office Word przeszukuje wszystkie węzły w dokumencie, aby tekst znajdujący się w węźle.

Parametry opcjonalne

Informacje na temat parametrów opcjonalnych można wyświetlić na Parametry opcjonalne w rozwiązaniach Office.

Przykłady

Następujący kod w przykładzie wykorzystano SelectSingleNode metody, aby węzeł podrzędny, który odpowiada danym XPath parametru.Przykład następnie wyświetla nazwę węzła, który został znaleziony.W tym przykładzie założono, że bieżący dokument zawiera XMLNode o nazwie CustomerNode z pasujący element schematu, który zawiera jeden lub więcej węzłów podrzędnych o nazwie LastName.

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

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

Zabezpieczenia programu .NET Framework

Zobacz też

Informacje

XMLNode Interfejs

Przestrzeń nazw Microsoft.Office.Tools.Word